DS-09 — Series Page Alignment Notes

DS-09 — Series Page Alignment Notes

Status: Complete
Branch: agent/ds-09-series-alignment
Pull request: #17 — DS-09 Align Series page
Merged: 2026-07-16
Merge commit: 6fa255bf06dbe6e0f485815ac09ab67edc6c7853

Existing behavior preserved

  • Series remain dynamically grouped from published posts using the series front-matter value.
  • Blank or missing series values remain excluded.
  • Posts within each series retain the existing series_order sequence.
  • Created, Fallen, Restored remains the preferred featured series when available; otherwise the first available group is used.
  • Series cards still lead to native expandable <details> reading lists.
  • Every reading-list entry still links directly to its published post.

Implemented

  • Assigned Series to the shared editorial landing-page archetype.
  • Replaced the older hero and nested feature with one framed split hero using the featured series image, description, and reflection count.
  • Preserved the 1280px editorial-board container and shared kicker, divider, button, panel, card, and status components.
  • Redesigned the All Series area as an editorial card grid without changing its dynamic Liquid source.
  • Added reader-facing fallbacks for missing descriptions and images.
  • Redesigned native <details> reading lists while preserving anchors, ordering, direct links, and browser-expanded states.
  • Added hash-aware expansion and focus behavior.
  • Added repeated-hash handling so a card can reopen a list that was manually closed while its hash remains active.
  • Added post subtitles when present and retained part numbers or dates for sequence context.
  • Removed reader-facing references to front matter, series:, and series_order.
  • Consolidated Reading Pathways into one cohesive closing panel.
  • Added scoped responsive, dark-mode, reduced-motion, long-title, and keyboard-focus styling.
  • Added the eight current series images to the rendered validation artifact.

Validation completed

  • Protected Jekyll and Sass production builds.
  • Eight published series remain present.
  • All 40 series post links remain present.
  • Every series retains the exact prior post-title order.
  • Featured-series selection remains Known & Loved under the current published content because the preferred future series is not yet present.
  • All eight card hashes resolve to matching <details> IDs.
  • Hash changes open and focus the matching summary.
  • Repeated same-hash card clicks reopen manually closed lists.
  • Native Enter-key summary toggling works.
  • Desktop visual review at 1440px.
  • Tablet visual review at 768px.
  • Mobile visual review at 390px.
  • Light- and dark-mode review.
  • No horizontal overflow at the tested widths.
  • Three-column, two-column, and one-column card-grid behavior.
  • Two-column and one-column reading-list behavior.
  • Long titles, one-post series, two-post series, and eleven-post series.
  • All nine rendered series image references exist and retain intrinsic proportions through object-fit: cover.
  • Keyboard tab order and visible three-pixel focus outlines for hero buttons, cards, summaries, open-list post links, and Search.
  • One h1, one main, one active Series navigation state, unique IDs, and no empty links.
  • No reader-facing implementation language remains.
  • All 60 compiled internal destinations checked from the Series page resolve in the artifact.
  • Home, Resources, Podcast, About, Professional Background, navigation, and footer regression review.

Evidence

  • Merged pull request: #17
  • Merge commit: 6fa255bf06dbe6e0f485815ac09ab67edc6c7853
  • GitHub Actions: protected Jekyll build run 54 passed on the exact final review commit.
  • Baseline comparison: the previous and redesigned pages contain identical series keys and identical ordered post-title arrays.
  • Compiled structure: eight cards, eight native <details> elements, and 40 direct post links.
  • Responsive metrics: document width matched viewport width at 1440px, 768px, and 390px.
  • Runtime behavior: hash activation focused the summary approximately 96px below the viewport top; same-hash reopening remained on the Series document.
  • Keyboard test: every page-specific control exposed the expected three-pixel gold focus outline.

Deferred

  • Individual per-series landing pages remain out of scope.
  • Changes to post front matter or series membership remain out of scope.
  • Search or filtering within Series remains out of scope.
  • Category archive pages remain out of scope.