Skip to content

Fold two docs sidebar categories into Guides so the site can deploy - #159

Merged
NSchatz merged 1 commit into
mainfrom
docs-sidebar-ia-spine
Sep 25, 2026
Merged

NSchatz merged 1 commit into
mainfrom
docs-sidebar-ia-spine

Conversation

@NSchatz

@NSchatz NSchatz commented Sep 25, 2026

Copy link
Copy Markdown
Contributor

docs.cosyte.com cannot deploy while @cosyte/x12 0.1.0 is the current release. The site's deploy-build IA gate (cosyte/docs Dispatch receiver run 36196140266) grades each package's current release sidebar, and this one fails it:

ERROR (STRICT) IA040 x12@v0.1.0: Top-level category label "Emitting X12" is not on the canonical spine
ERROR (STRICT) IA040 x12@v0.1.0: Top-level category label "Trading partners" is not on the canonical spine

What changes

Both pages are task guides, so emit-and-serialize and profiles move into Guides ahead of the cookbook, in the order they already had. Page order is unchanged, so every sidebar_position still ascends in sidebar order, and no page id, file name or URL changes.

Top level after: intro, Installation, Quickstart, Core Concepts, Guides, Troubleshooting

Verification

  • The docs site's own runLint (strict) over pnpm pack:docs output staged as the current version slot: base reproduces both errors, this branch reports OK: all checked packages conform to the IA spine.
  • pnpm test (including test/docs-content.test.ts), pnpm format:check, pnpm check:no-emdash, pnpm check:no-internal-refs, pnpm phi-scan, and the shared docs-content-check.mjs: all green locally.

No changeset: docs-content/ is not in the npm tarball, so the published package does not change. The fix reaches the site through the v0.1.0 release's docs-content.tar.gz, repacked from the release commit plus this change.

https://claude.ai/code/session_01U24bnHKNxQWMxmfN7ny7w9

docs.cosyte.com cannot deploy while @cosyte/x12 0.1.0 is the current release: the site's
deploy-build IA gate grades each package's current release sidebar, and this one fails it
(cosyte/docs Dispatch receiver run 36196140266):

  IA040 x12@v0.1.0: top-level category "Emitting X12" is not on the canonical spine
  IA040 x12@v0.1.0: top-level category "Trading partners" is not on the canonical spine

The site allows only Overview, Installation, Quickstart, Core Concepts, Guides and
Troubleshooting as top-level category labels. Both pages are task guides, so they move into
Guides ahead of the cookbook, in the order they already had. The order of every page is
unchanged, so each sidebar_position still ascends in sidebar order, and no page id, file
name or URL changes.

No changeset: docs-content/ is not in the npm tarball, so the published package does not
change. The fix reaches the site through the v0.1.0 release's docs-content.tar.gz, repacked
from the release commit plus this change.

Claude-Session: https://claude.ai/code/session_01U24bnHKNxQWMxmfN7ny7w9
@NSchatz
NSchatz enabled auto-merge (squash) September 25, 2026 22:50
@NSchatz
NSchatz merged commit 86a06ea into main Sep 25, 2026
12 checks passed
@NSchatz
NSchatz deleted the docs-sidebar-ia-spine branch September 25, 2026 22:53
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