Skip to content

Commit e0dd6bf

Browse files
committed
docs: close the editorial rollout
1 parent 46c059f commit e0dd6bf

2 files changed

Lines changed: 52 additions & 37 deletions

File tree

EDITORIAL-ROADMAP.md

Lines changed: 32 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -34,10 +34,10 @@ changing content.
3434

3535
### What we ship
3636

37-
- [ ] Add the narrative canon to `TONE.md`.
38-
- [ ] Update `TONE.md` section 7 for the current project and legacy-route state.
39-
- [ ] Add a historical errata to `REDESIGN.md`.
40-
- [ ] Correct the PRD and this roadmap so scope, terminology, rollout, and
37+
- [x] Add the narrative canon to `TONE.md`.
38+
- [x] Update `TONE.md` section 7 for the current project and legacy-route state.
39+
- [x] Add a historical errata to `REDESIGN.md`.
40+
- [x] Correct the PRD and this roadmap so scope, terminology, rollout, and
4141
acceptance criteria agree.
4242

4343
### Done when
@@ -57,10 +57,10 @@ content model before deleting it.
5757

5858
### What we ship
5959

60-
- [ ] Create `src/data/harness-redirects.ts` with stable IDs and PT/EN slugs.
61-
- [ ] Move legacy alternate-link generation into the redirect manifest.
62-
- [ ] Update both dynamic redirect routes to consume the new manifest.
63-
- [ ] Keep both overview redirect routes unchanged except for any helper rename
60+
- [x] Create `src/data/harness-redirects.ts` with stable IDs and PT/EN slugs.
61+
- [x] Move legacy alternate-link generation into the redirect manifest.
62+
- [x] Update both dynamic redirect routes to consume the new manifest.
63+
- [x] Keep both overview redirect routes unchanged except for any helper rename
6464
required by the manifest.
6565

6666
### Done when
@@ -83,17 +83,17 @@ infrastructure without changing live features.
8383

8484
### What we ship
8585

86-
- [ ] Delete `src/components/harness/`, `HarnessChapterLayout.astro`,
86+
- [x] Delete `src/components/harness/`, `HarnessChapterLayout.astro`,
8787
`harness-chapter.css`, `src/lib/harness-progress.ts`, and
8888
`src/data/harness-chapters.ts`.
89-
- [ ] Remove the harness UI block from `src/lib/i18n.ts`.
90-
- [ ] Delete the four unwired `Hero*` directories.
91-
- [ ] Delete `src/lib/liveblocks.ts`, remove Liveblocks dependencies, update
89+
- [x] Remove the harness UI block from `src/lib/i18n.ts`.
90+
- [x] Delete the four unwired `Hero*` directories.
91+
- [x] Delete `src/lib/liveblocks.ts`, remove Liveblocks dependencies, update
9292
both lockfiles, remove the obsolete environment entry, and remove the global
9393
Liveblocks badge rule.
94-
- [ ] Keep `motion`; `src/components/motion/Reveal.tsx` still imports it.
95-
- [ ] Remove the unused session `accent` property.
96-
- [ ] Update PT/EN kitchen-sink copy to the current type system and dash rules.
94+
- [x] Keep `motion`; `src/components/motion/Reveal.tsx` still imports it.
95+
- [x] Remove the unused session `accent` property.
96+
- [x] Update PT/EN kitchen-sink copy to the current type system and dash rules.
9797

9898
### Done when
9999

@@ -115,12 +115,12 @@ curriculum.
115115

116116
### What we ship
117117

118-
- [ ] Naturalize the four flagged EN lesson passages.
119-
- [ ] Reduce the repeated two-beat contrasts in both maturity lessons, keeping
118+
- [x] Naturalize the four flagged EN lesson passages.
119+
- [x] Reduce the repeated two-beat contrasts in both maturity lessons, keeping
120120
the strongest closing move.
121-
- [ ] Backport "When to automate" and "What to take from here" to PT publish.
122-
- [ ] Expand PRD on first use in both build chapters.
123-
- [ ] Replace the `2–3` range in both planning chapters.
121+
- [x] Backport "When to automate" and "What to take from here" to PT publish.
122+
- [x] Expand PRD on first use in both build chapters.
123+
- [x] Replace the `2–3` range in both planning chapters.
124124

125125
### Done when
126126

@@ -141,11 +141,11 @@ possible copy-only change.
141141

142142
### What we ship
143143

144-
- [ ] One-line curriculum lede naming vocabulary, tools, method, and ownership.
145-
- [ ] One-line blog lede distinguishing field essays from the curriculum.
146-
- [ ] One-line project lede connecting theory to practice.
147-
- [ ] Equivalent treatment in English.
148-
- [ ] Reuse `.section-head__lede`; do not add components, layout rules, images,
144+
- [x] One-line curriculum lede naming vocabulary, tools, method, and ownership.
145+
- [x] One-line blog lede distinguishing field essays from the curriculum.
146+
- [x] One-line project lede connecting theory to practice.
147+
- [x] Equivalent treatment in English.
148+
- [x] Reuse `.section-head__lede`; do not add components, layout rules, images,
149149
or motion.
150150

151151
### Done when
@@ -167,14 +167,15 @@ possible copy-only change.
167167

168168
### What we ship
169169

170-
- [ ] Update the redesign track and follow-ups in `ROADMAP.md` to remove stale
170+
- [x] Update the redesign track and follow-ups in `ROADMAP.md` to remove stale
171171
harness, hero-toy, and Liveblocks work.
172-
- [ ] Run the full quality gate under Linux Node 22.
173-
- [ ] Verify all generated legacy redirect pages and locale alternates.
174-
- [ ] Run editorial candidate scans and manually triage comment-only matches.
175-
- [ ] Review both locales, both themes, and representative mobile/desktop
172+
- [x] Run the full quality gate under Linux Node 22.
173+
- [x] Verify all generated legacy redirect pages and locale alternates.
174+
- [x] Run editorial candidate scans and manually triage comment-only matches.
175+
- [x] Review both locales, both themes, and representative mobile/desktop
176176
widths.
177-
- [ ] Push local `main` once all checks pass.
177+
- Push local `main` once all checks pass. This is the final release operation,
178+
performed after the completion commit.
178179

179180
### Quality gate
180181

ROADMAP.md

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -226,17 +226,31 @@ Full visual redesign replacing Neo Brutalism with the editorial system defined i
226226
- [x] Phase 1 — Foundations: tokens (both themes), typography, fonts, favicon
227227
- [x] Phase 2 — Primitives: Button, Badge, Card (+ `index` prop), kitchen-sink as permanent design-system page
228228
- [x] Phase 3 — Chrome: SiteHeader (red-square wordmark), ThemeToggle, Footer, SectionNav
229-
- [x] Phase 4+5 — Home de-gimmick (toy layer unwired; dirs pending `git rm`) + editorial home (pt/en): masthead hero, feature story, curriculum grid, manifesto band, more-from rows
229+
- [x] Phase 4+5 — Home de-gimmick + editorial home (pt/en): masthead hero, feature story, curriculum grid, manifesto band, more-from rows; toy layer removed in the editorial cleanup track
230230
- [x] Phase 6 — Article template: SessionLayout, BlogPostLayout, NextSessionCTA, ReferencesList (numbered endnotes), ProgressTracker (2px bar), Discussion
231231
- [x] Phase 7 — Secondary templates I: blog index (pt/en), colinha (pt/en)
232-
- [x] Phase 8 — Secondary templates II: projeto pages, harness pages, 404 (pt/en), ChapterLayout, HarnessChapterLayout, `harness-chapter.css`
233-
- [x] Phase 9 — Deps & docs: `motion` dependency removed, AGENTS.md design section replaced, this track
234-
- [ ] Phase 10 — Final validation gate (`lint` + `format:check` + `build`, full click-through, both themes/locales) + single push
232+
- [x] Phase 8 — Secondary templates II: projeto pages, legacy harness redirect pages, 404 (pt/en), ChapterLayout
233+
- [x] Phase 9 — Deps & docs: `motion` retained for the shared Reveal island, AGENTS.md design section replaced, this track
234+
- [x] Phase 10 — Final validation gate (`lint` + `format:check` + `build`, full click-through, both themes/locales)
235235

236236
### Follow-ups after the redesign ships
237237

238-
- [ ] `git rm -r src/components/HeroStickers src/components/HeroGhostCursors src/components/HeroCursorTrail src/components/HeroCaptureCounter` (already unwired from all pages/layouts)
239238
- [ ] Sweep legacy token aliases, then delete the alias block in `tokens.css` and the `brutal-*` keyframes in `globals.css`:
240239
`grep -rn "accent-[1-4]\|fg-on-yellow\|fg-on-blue\|fg-on-green\|fg-on-coral\|border-thick\|color-shadow\|font-heading\|ease-snap\|ease-out-back\|brutal-\|color-white\|color-primary\|color-border\b" src/`
241-
- [ ] Migrate island CSS internals (ChapterNav, ChapterFooter, harness/\*) to semantic tokens — they currently inherit the new look through the legacy aliases
240+
- [ ] Migrate remaining island CSS internals, including ChapterNav and ChapterFooter, to semantic tokens; the discontinued harness islands were removed
242241
- [ ] PLAN.md design-language sweep (historical discovery doc; design source of truth is now `REDESIGN.md` + `AGENTS.md`)
242+
243+
---
244+
245+
## Editorial Track: Voice, Tone, and Narrative
246+
247+
The editorial cleanup and narrative canon are defined in
248+
[`PRD-EDITORIAL.md`](PRD-EDITORIAL.md) and executed through
249+
[`EDITORIAL-ROADMAP.md`](EDITORIAL-ROADMAP.md).
250+
251+
- [x] Phase 1 — Narrative canon and active-documentation alignment
252+
- [x] Phase 2 — Stable manifest for all legacy harness redirect URLs
253+
- [x] Phase 3 — Discontinued harness, hero toys, and Liveblocks removed
254+
- [x] Phase 4 — Targeted lesson corrections and PT/EN project parity
255+
- [x] Phase 5 — Home narrative ledes in both locales
256+
- [x] Phase 6 — Quality gate, editorial scans, redirect checks, and browser review

0 commit comments

Comments
 (0)