Skip to content

fix(docs): keep Beta promotion checks proportional - #643

Merged
jeremi merged 2 commits into
mainfrom
codex/fix-docs-llms-archive
Aug 1, 2026
Merged

fix(docs): keep Beta promotion checks proportional#643
jeremi merged 2 commits into
mainfrom
codex/fix-docs-llms-archive

Conversation

@jeremi

@jeremi jeremi commented Aug 1, 2026

Copy link
Copy Markdown
Member

Why

The v0.16.3 docs promotion applied the current machine-readable-doc check to 19 immutable historical archives. It failed on 1,795 generated OpenAPI routes that intentionally have no Markdown twin. The next local smoke also used a stale canonical-URL expectation for the separately bound immutable version tree.

Changes

  • scope the existing current machine-doc check to dist/dev
  • preserve full assembled-tree SEO, link, digest, and route checks
  • validate /v/<version>/ against its immutable version canonical URL
  • restore focused structure and smoke coverage

No release artifact, archive, product behavior, permission, or publication step changes.

Verification

  • actionlint passed
  • 267 docs unit tests passed
  • 19 release workflow structure tests passed
  • exact v0.16.3 archive assembly and staging replay passed
  • machine docs: 175 passed, 0 failed
  • full-tree SEO and 782657-link checks passed
  • exact staged route smoke passed
  • independent final review approved

After merge, only the docs workflow is dispatched again with the same published v0.16.3 archive SHA. The release is not rebuilt or mutated.

jeremi added 2 commits August 2, 2026 03:11
Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>
Signed-off-by: Jeremi Joslin <jeremi@joslin.fr>

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 059222f756

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread .github/workflows/docs-pages.yml
Comment thread .github/workflows/docs-pages.yml
@jeremi
jeremi merged commit b8ed78f into main Aug 1, 2026
28 checks passed
@jeremi
jeremi deleted the codex/fix-docs-llms-archive branch August 1, 2026 20:25
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