Skip to content

docs: rename Facility envelope -> Facilities; flatten + generate site asset binding#307

Merged
xmap merged 1 commit into
mainfrom
docs/facilities-flatten
Jun 22, 2026
Merged

docs: rename Facility envelope -> Facilities; flatten + generate site asset binding#307
xmap merged 1 commit into
mainfrom
docs/facilities-flatten

Conversation

@xmap

@xmap xmap commented Jun 22, 2026

Copy link
Copy Markdown
Owner

Revives the unique half of the closed #291: the Facility-envelope rename + flatten + generated asset binding. The TomoWISE-spec tabulation half of #291 is omitted (already shipped by #305).

  • Rename Facility envelope -> Facilities (nav section + index.md heading and prose).
  • Flatten: each Site collapses from a {index, Assets} subsection to a single index entry; the standalone aps/assets.md + maxiv/assets.md pages are deleted.
  • Generate: scripts/site_pages.py now emits the Asset-binding table (Asset | Tier | facility_code | Hosts) inline on each Site index from the descriptor, so it is generated-honest instead of hand-maintained.
  • index.md prose simplified.

mkdocs --strict clean (generated site indexes carry the table; no dangling links to the removed pages) and deployment unit tests pass.

Held for review — not auto-merged.

🤖 Generated with Claude Code

…site asset binding

Salvages the unique half of the closed #291 (the TomoWISE-tabulation half is
already done by #305, so it is omitted here).

- Rename: the "Facility envelope" nav section and the index.md heading/prose
  become "Facilities"; each Site collapses from a {index, Assets} subsection to
  a single index entry.
- Flatten + generate: drop the standalone docs/deployments/{aps,maxiv}/assets.md
  pages; scripts/site_pages.py now generates the Asset-binding table
  (Asset | Tier | facility_code | Hosts) inline on each Site index from the
  descriptor (_modeled now takes facility_code + beamlines).
- index.md prose simplified (the three-row scope table folded into prose).

mkdocs --strict and the deployment unit tests (incl. test_site_descriptor) pass.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@xmap xmap force-pushed the docs/facilities-flatten branch from 70c7acf to 902cf6b Compare June 22, 2026 08:24
@xmap xmap enabled auto-merge (squash) June 22, 2026 08:28
@github-actions

Copy link
Copy Markdown

Coverage report

This PR does not seem to contain any modification to coverable code.

@xmap xmap merged commit 0c6c301 into main Jun 22, 2026
16 checks passed
@xmap xmap deleted the docs/facilities-flatten branch June 22, 2026 08:35
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