Skip to content

docs(shard): use neutral names for the example build lists - #49

Merged
HaoZeke merged 1 commit into
mainfrom
fix/site-names
Nov 16, 2026
Merged

HaoZeke merged 1 commit into
mainfrom
fix/site-names

Conversation

@HaoZeke

@HaoZeke HaoZeke commented Nov 16, 2026

Copy link
Copy Markdown
Collaborator

The shard how-to, tests and fixtures use neutral names (site-2026e.list, site-zen2) instead of one site's token, and the walkthrough forbids that token.

  • The page built Snel-2026e.list, and the shard tests and fixtures carried the same site's names in list headers and in --include-systems. CONTRIBUTING.md keeps site hostnames, paths and private names in the site target layer, out of the public files. The page now builds site-2026e.list, the header reads "# Wave 1, rome", and the --include-systems values are site-zen2 and site. FORBIDDEN in doc_walkthrough.rs gains Snel, so a how-to bash block that names that site fails howto_bash_blocks_name_files_in_this_checkout.

The commit has a towncrier fragment. Main has no towncrier yet; #26 (fix/towncrier) adds it.

stack-shard.org showed --build-list Snel-2026e.list twice, and the
shard tests and fixtures carried the same site's names: a "# Snel
wave 1, rome" header in wave1.list, a "# Snel-2026 header" list in the
jenkins tests, and --include-systems=snel-zen2 (or snel) on lines in
the shard_sources, site_commands, stack_shard and stack_shard_sources
tests and in opaque.list. CONTRIBUTING.md keeps site hostnames, paths
and private names in the site target layer, out of the public files.

The page now builds site-2026e.list, the header reads "# Wave 1,
rome", and the --include-systems values are site-zen2 and site. The
tests check the same behaviour, since those values pass through
verbatim.

FORBIDDEN in doc_walkthrough.rs gains "Snel", so a how-to bash block
that names that site fails howto_bash_blocks_name_files_in_this_checkout.
With that token the test fails on main.
@HaoZeke
HaoZeke merged commit 94aa200 into main Nov 16, 2026
21 checks passed
@HaoZeke
HaoZeke deleted the fix/site-names branch November 16, 2026 05:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant