Build: The Refinement
build/build-9-1-the-refinement.md Build: The Refinement
Points: 10 (Complete/Incomplete) Time Estimate: 90โ120 minutes Prerequisite: Practice 9-1 + Engage 9-1 (Peer Review)
TL;DR
Address peer feedback. Polish everything. Deploy. This is the final build before presentation.
Submit
- Push final version to GitHub
- Submit GitHub Pages URL to Canvas
- Ensure site is linked from your portfolio
Overview
This is it. After this build, your scrollytelling site is done. Week 10 is presentations โ no more build time. Everything you submit Sunday is what you present.
What You're Doing
Step 1: Address Peer Feedback
Review the feedback you received. Prioritize:
- Confusion points โ If your partner got lost, other people will too. Fix the content or transitions.
- Pacing issues โ Adjust scroll ranges, add breathing room, or trim overly long sections.
- Accessibility failures โ Any Y/N "No" from the accessibility tests needs to be fixed.
Step 2: Accessibility Audit
Run through this checklist yourself:
- Keyboard: Tab through every section. All content reachable?
- Reduced Motion: Enable in System Settings. Everything visible? No broken layouts?
- Contrast: Check text on every background. Use WebAIM Contrast Checker.
- Headings: h1 โ h2 โ h3 with no skipping. Run a heading check in DevTools or browser extension.
- Landmarks:
<main>wraps content. Sections use<section>. - Images: All
<img>tags havealtattributes (emptyalt=""for decorative images).
Step 3: Performance Pass
Open Chrome DevTools โ Lighthouse tab โ Generate Report (Performance + Accessibility).
Quick wins if score is low:
- Compress images (use squoosh.app)
- Add
loading="lazy"to images below the fold - Remove unused CSS
- Make sure no animations use expensive properties (
box-shadow,filteron scroll)
Step 4: Final Content Edit
Read your entire site one more time. Out loud. Fix:
- Typos
- Sentences that only make sense to you
- Metaphor inconsistencies
- Sections that feel rushed or underwritten
Step 5: Remove All Debug Code
- All
markers: trueremoved from ScrollTrigger configs - No
console.log()statements in production code - No commented-out code blocks
- No
TODOcomments
Step 6: Deploy
- Push to GitHub
- Verify GitHub Pages is serving the latest version (check the deployment status)
- Link from your portfolio (add a nav link or project card)
Step 7: Prep for Presentation
In Week 10, you'll present for 5โ7 minutes. Plan:
- Live scroll-through demo
- Which section's code you'll walk through
- Your metaphor explanation (1 minute max)
- What surprised you / what you'd change
Complete Criteria
- Peer feedback addressed (at least 2 visible changes)
- Accessibility audit passed (all checklist items)
- Performance: no major jank or layout shifts
- All content proofread
- All markers and debug code removed
- Deployed to GitHub Pages
- Linked from portfolio
- README updated with project description
Connection to This Week
This is the last build. Next week you present. The work you submit Sunday is your final deliverable for Project 2: The Long Way Down โ 50% of your course grade.