Skip to content

Rules website: Starlight site generated from RULES.md and README.md - #20

Merged
iacoware merged 14 commits into
mainfrom
rules-website
Oct 27, 2026
Merged

iacoware merged 14 commits into
mainfrom
rules-website

Conversation

@iacoware

@iacoware iacoware commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

Implements the spec #11: a Starlight site in website/, generated at build time from RULES.md and README.md, deployed to GitHub Pages.

Closes #11
Closes #12
Closes #13
Closes #14
Closes #15
Closes #16
Closes #17
Closes #18
Closes #19

Manual step: GitHub Pages is not enabled on the repo yet. Before merging, go to Settings → Pages → Source and select "GitHub Actions", or the first deploy fails.

…s from main; setup action takes a working-directory input
… to Starlight by a content loader, with a demo page replacing the Starlight demo content
* origin/rules-website:
  website workflow builds the site on PRs and deploys it to GitHub Pages from main; setup action takes a working-directory input
…th its section body, replacing the demo page
* origin/rules-website:
  website pages come from a content module (Markdown in, pages out) fed to Starlight by a content loader, with a demo page replacing the Starlight demo content
  website workflow builds the site on PRs and deploys it to GitHub Pages from main; setup action takes a working-directory input
* ticket-19:
  website gets an Effect-like zinc theme with Inter and JetBrains Mono, and header links to npm and issues
…ev/next in catalog order, drops the back link and fails the build naming the rule when a section breaks the catalog template
* origin/rules-website:
  website gets an Effect-like zinc theme with Inter and JetBrains Mono, and header links to npm and issues
…the sidebar, rewrites RULES.md anchor links to site routes and fails the build naming a link that resolves to no page
… links to Installation and the rules index, Installation, Configuration, Rules overview, Default configuration and Versioning in the sidebar, without Development; README links point to site pages or to repository files on GitHub, and an unresolvable one fails the build
…egex, back link and published site options (base, repositoryUrl) across sources, astro config and tests; build errors name a page's location
… internalLinks, sitePages link resolution), real-file tests are rulesMdAlignment and readmeMdAlignment, assert each rewritten link equals the route of its source anchor and check RULES.md repository-file links exist
@iacoware
iacoware marked this pull request as ready for review October 27, 2026 16:37
@iacoware
iacoware merged commit 6508ea8 into main Oct 27, 2026
2 checks passed
@iacoware
iacoware deleted the rules-website branch October 27, 2026 16:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment