From 2d375f6c586e9b2f5b527d6bea13e3c3deed87f7 Mon Sep 17 00:00:00 2001 From: Noah Schatz Date: Fri, 25 Sep 2026 22:49:07 +0000 Subject: [PATCH] Move the conformance statement into the docs Guides category The docs site's deploy-build IA gate grades each package's current release sidebar, and the sidebar on main would fail it the moment it ships in a release: IA040 mllp: top-level category "Conformance" is not on the canonical spine (reproduced with the site's own lint over `pnpm pack:docs` output at 9c339c1). A red gate there stops every docs.cosyte.com deploy, not only this package's pages, and this is the sidebar the next release would pack. The site allows only Overview, Installation, Quickstart, Core Concepts, Guides and Troubleshooting as top-level category labels, and a label after Troubleshooting has no canonical home. The statement moves into Guides after the testing page, which is where @cosyte/ccda already keeps its conformance page. The docs structure test requires sidebar_position to ascend in sidebar order, so the statement takes 9 and the limitations page, now last, takes 10. The statement stays in the sidebar, 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. Claude-Session: https://claude.ai/code/session_01U24bnHKNxQWMxmfN7ny7w9 --- docs-content/conformance.md | 2 +- docs-content/limitations.md | 2 +- docs-content/sidebars.json | 7 +------ 3 files changed, 3 insertions(+), 8 deletions(-) diff --git a/docs-content/conformance.md b/docs-content/conformance.md index c31e2df..b4ea469 100644 --- a/docs-content/conformance.md +++ b/docs-content/conformance.md @@ -4,7 +4,7 @@ title: Conformance statement description: >- The self-declared conformance statement: framing tolerances, per-role acknowledgement verdicts, IHE options in actor-and-option terms, and what stays the deploying actor's to do. -sidebar_position: 10 +sidebar_position: 9 --- # Conformance statement diff --git a/docs-content/limitations.md b/docs-content/limitations.md index 5bdbf35..09a1006 100644 --- a/docs-content/limitations.md +++ b/docs-content/limitations.md @@ -4,7 +4,7 @@ title: Known limitations & non-goals description: >- What not to trust this transport to do: delivery guarantees, batch acknowledgement, Release 2, charsets that collide with the framing bytes, and where the public surface stands today. -sidebar_position: 9 +sidebar_position: 10 --- # Known limitations & non-goals diff --git a/docs-content/sidebars.json b/docs-content/sidebars.json index 3499f3c..021ef3f 100644 --- a/docs-content/sidebars.json +++ b/docs-content/sidebars.json @@ -20,17 +20,12 @@ { "type": "category", "label": "Guides", - "items": ["reliability", "tls", "testing"] + "items": ["reliability", "tls", "testing", "conformance"] }, { "type": "category", "label": "Troubleshooting", "items": ["limitations"] - }, - { - "type": "category", - "label": "Conformance", - "items": ["conformance"] } ] }