Repository navigation
Reference: a Package section, Conformance in its own section, the Observatory page - #161
Merged
Merged
Conversation
added 3 commits
November 9, 2026 12:48
…ervatory page - reference/congregation moves under reference/package (config.idp and comline.toml), with the schema reference beside it. - reference/conformance.md splits into reference/conformance/: the pipeline, wire and generator conformance, fuzzing, benchmarks, timings, size and coverage, and reports and the Observatory. - reference/tools/cli.md becomes reference/tools/cli/ beside its subcommand pages; a new reference/tools/observatory.md. - Links across the guides, the developer pages and the reference follow the moves; the drift workflows and scripts point at the new paths.
…page The std pages' URL (reference/schema/std/) is linked from code: generation's STD_DOCS, the default std link in every `comline doc` output, and cli's docs and tests. The schema pages keep their path and are listed under Package in the nav instead; the std sync script and drift workflow keep theirs too. Also: reference/tools/observatory.md in the nav under Tools, and the Extending page's link to the Guides one directory further up.
…ypescript#75 fixed)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Restructures the Reference section.
Moves
reference/congregation/(config.idp,comline.toml) moves toreference/package/congregation/, under a new Package section with the schema reference beside it.reference/schema/, and is listed under Package in the nav. The std pages' URL,reference/schema/std/, is linked from code: generation'sSTD_DOCS, which is the default std link in everycomline docoutput, and cli's docs and tests. Keeping the path avoids a cross-repo change.reference/conformance.mdsplits intoreference/conformance/with these pages:#the-ops-protocolis now onconformance/wire;reference/tools/cli.mdbecomesreference/tools/cli/index.md, besideinspectanddoc. The URL is unchanged.reference/tools/observatory.md, listed under Tools.Follow-ups to the moves
check-cli-drift.pypoint atcli/index.md.nav.csscache-buster goes to v23.Rebased onto main
These upstream changes are carried into the moved pages, with their links re-pointed:
specification_versionrow andcomline fixrow;datagram@3andcomline@2defaults;conformance --json;generaterow's wire-numbers text.Every other upstream file is unchanged. Also fixes the Extending page's link to the Guides, which pointed one directory too shallow.
Checks
zensical build --strictpasses locally with no issues.reference/schema/std/http/at its old URL, the moved pages, and the Editions section.