AstroLog PIR®
All GitHub home & brand entries

The assets shelf gets a walkthrough, and the pipeline breathes again

HighGitHub home & brand 2 min readBy Christopher W
TL;DR: The sync pipeline is whole again: the frontmatter typo is fixed, the two screenshots are home in assets/ (moved by Christopher through github.dev), the shelf now has its own friendly walkthrough page, and the arrival kit learns flyout side menus plus a Desks group - staged and riding with the next hub push.
Read the full story →

🩹 How the pipeline got stuck (and unstuck)

Three causes, stacked like dominoes:

  1. The loader is non-recursive. Desk entries landed in subfolders (bod/, intergroup/) and the content loader only reads the top of changelog/. Fixed by keeping every entry flat and letting the repo: frontmatter assign its desk.
  2. A frontmatter typo. The Convention Hub’s night-sky entry carried repo: "wordpress / convention-hub" - spaces around the slash - which produced a route with no valid repo parameter and killed every build with “Missing parameter: repo”. The desk is now convention-astro, matching its sibling entries; the entry’s words were untouched.
  3. Screenshots loose at the repo root. The validate step expects every root path to be classified, and two freshly-dropped screenshots weren’t. Christopher moved both into assets/ with their convention names - 2025-10-08-david-lee-ticket-102161.png and 2026-10-14-xdn-panel-main-domain-building.png - using github.dev, GitHub’s editor in the browser.

🪞 An honest note

During the repair, one of the keeper’s own pushes went out with placeholder text that briefly overwrote the David L memorial and the XDN entry. Both were restored within the hour from the public build, and nothing public ever changed - the site was already stalled. The lesson is now a standing rule in the workshop: real content in hand before any push. The ledger makes no exceptions for its own keepers.

📖 The walkthrough

The shelf now has a walkthrough of its own, built in the same night-sky style as the Gallery’s: three paths - send it to a trusted servant, use GitHub in your browser (github.dev included), or walk the full terminal process - plus the naming convention, the privacy care, and the promise that nothing here can break the site. The README keeps its 60-second version and points to the new page.

🧭 The arrival kit 1.3.1 (staged)

In the hub’s arrival/ folder, ready for its next push:

  • The More panel grows side menus. Each category - Gatherings, Helpers, Get involved, About, Desks - is now a parent: tap it and a scrollable side menu opens beside the panel, positioned to fit the screen, closable with the Escape key or a click away.
  • The Desks group joins the nav. All twelve committee desks - WordPress sites, A.L.E.X. & helpdesks, GitHub home & brand, Tech Com, Board, Intergroup, GSR, PR, Publications, Newspaper, Book, Lit Com - each linking to its own stream of entries.
  • The panel’s list scrolls in its own wrapper now, so the side menus never get clipped by the tree.

The ledger keeps its own house in order, then shows everyone how it’s done.