Skip to content

Document the 003 editorial deck: architecture.md + ADR 0004 - #229

Merged
brunogbv merged 1 commit into
mainfrom
003-docs
Jul 5, 2026
Merged

brunogbv merged 1 commit into
mainfrom
003-docs

Conversation

@brunogbv

@brunogbv brunogbv commented Jul 5, 2026

Copy link
Copy Markdown
Owner

Completes the last two milestone-003 tasks — the docs that shipped after the implementation. Closes #210, Closes #211.

docs/architecture.md (#210)

Brought in sync with the shipped deck (and the #226 Skills rework):

  • Rewrote Template & styling for the full-viewport scroll-snap deck, the card rails + :target detail overlays, the Through-Line signature, and the pure-CSS swipe affordance; documented deck.js / overlay.js / reveal.js.
  • Added the screen-only vendored Fraunces + Spline Sans; fixed the skills data-model row (now [{ category, kind, items }], no proficiency %); noted pdf-visual.spec.js in the layout + Tests.

docs/adr/0004-native-scroll-snap-editorial-deck.md (#211, NEW)

The decision to build the CV as a native-scroll-snap deck (rails + :target overlays, screen-only, one signature). Notably records that decision 5 reverses ADR 0003's "pdf.js unchanged (no emulateMedia)" — pdf.js now emulates print media before navigating — and ties the tall-fullPage-gate trade-off to the open follow-ups (#225/#221/#223). Indexed in docs/adr/README.md; added an "Update (003)" back-reference note to ADR 0003 scoping what changed (decision 2) vs what stands (1 and 3).

Verification

Two review passes confirmed every architecture.md claim is true against the shipped code and ADR 0004 is accurate/consistent. markdownlint clean; all cross-doc links resolve. Docs-only — no site/PDF impact.

Merging this closes milestone 003 (last 2 of 30 issues).

🤖 Generated with Claude Code

Bring the docs in sync with the shipped 003 interactive deck (and the #226
Skills rework).

- docs/architecture.md — rewrote "Template & styling" for the full-viewport
  scroll-snap deck, card rails + :target detail overlays, the Through-Line,
  and the pure-CSS swipe affordance; added deck.js/overlay.js and the vendored
  screen-only Fraunces + Spline Sans; fixed the `skills` data-model row (now
  `[{category, kind, items}]`, no proficiency %); noted pdf-visual.spec.js.
- docs/adr/0004-native-scroll-snap-editorial-deck.md (NEW) — the decision to
  build the CV as a native-scroll-snap deck (rails + :target overlays,
  screen-only, one signature). Records that decision 5 REVERSES ADR 0003's
  "pdf.js unchanged (no emulateMedia)" — pdf.js now emulates print media before
  navigating — and links the fullPage-gate trade-off to the open follow-ups
  (#225/#221/#223).
- docs/adr/README.md — indexed 0004; docs/adr/0003 — added an "Update (003)"
  note scoping what changed (decision 2) vs what stands (1 and 3).

Verified factually accurate against the shipped code (two review passes,
clean); markdownlint clean; all cross-doc links resolve.

Closes #210
Closes #211
@github-actions

github-actions Bot commented Jul 5, 2026

Copy link
Copy Markdown

🔺 Vercel preview: https://cv-cm4lo769s-bruno-valerios-projects.vercel.app

commit 31d0a69 · updated 2026-07-05 20:10 UTC

@brunogbv
brunogbv merged commit 54aaf29 into main Jul 5, 2026
13 checks passed
@brunogbv
brunogbv deleted the 003-docs branch July 5, 2026 20:12

This branch was successfully deployed

1 active deployment
preview-pr-229 — 31d0a69d Deployed Jul 5, 2026 by github-actions[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment