docs: add historical documentation migration tooling - #259
Merged
Conversation
added 17 commits
August 14, 2026 02:52
nicklambourne
force-pushed
the
codex/legacy-docs-tooling
branch
from
August 13, 2026 18:51
2525a7f to
ac341b7
Compare
nicklambourne
force-pushed
the
codex/legacy-docs-tooling
branch
from
August 13, 2026 18:55
ac341b7 to
517b0b4
Compare
Run push-triggered workflows only for master (PR branches already get pull_request runs, and stacked branches previously got neither), and drop the pull_request branches filter so pull requests targeting stacked train branches receive checks before they are retargeted to master. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
The docs-example test resolves the package by name at runtime, and the docs build sets its own UV_CACHE_DIR so the setup-uv cache post-step fails on an empty cache path. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
nicklambourne
marked this pull request as ready for review
August 14, 2026 12:59
nicklambourne
added a commit
that referenced
this pull request
Aug 17, 2026
* chore: move Python package into workspace * test: establish shared conformance contract * feat: add TypeScript package * ci: add coordinated package release automation * docs: migrate site to Docusaurus * feat: make docs language selection site-wide * docs: complete language-specific guides * feat: expose versioned documentation * feat: standardise TypeScript block factory names * docs: improve API reference generation and navigation * test: enforce comprehensive conformance coverage * feat: support current Block Kit blocks in Python * feat: support current Block Kit blocks in TypeScript * docs: bring TypeScript API reference to parity * docs: add validated Block Kit previews * ci: align monorepo validation * chore: prepare 2.1.0 release * docs: add legacy migration contract and tooling * ci: give stacked pull requests check runs Run push-triggered workflows only for master (PR branches already get pull_request runs, and stacked branches previously got neither), and drop the pull_request branches filter so pull requests targeting stacked train branches receive checks before they are retargeted to master. * ci: give stacked pull requests check runs * ci: give stacked pull requests check runs * ci: build the smoke package before switching to the matrix Node pnpm 11.16 requires Node 22.13+, so the Node 20.19 smoke leg must install and build under the runner's default Node and only then switch versions for the import checks. * ci: pin setup-uv to an existing tag astral-sh/setup-uv publishes no moving v10 tag, so the docs workflow could not resolve its action. * ci: alias the package name for docs-example typechecking The docs-example test imports docs/examples/typescript/section_hello.ts, which imports the package by name; tsc needs the same alias vitest uses. * ci: resolve the package alias in vitest and skip the unused uv cache The docs-example test resolves the package by name at runtime, and the docs build sets its own UV_CACHE_DIR so the setup-uv cache post-step fails on an empty cache path. ---------
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
1 participant
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.
Historical documentation train 1/6.
Depends on #258 and records its final base commit as
a188c2c.This PR adds the migration contract and reproducible tooling:
origin/gh-pagesinventory at747ca39861503fbece849e375c9843641f87684c;The source plan itself is intentionally not included.