Skip to content

Feat/docs versions skills and packages - #54

Closed
kieronlanning wants to merge 3 commits into
mainfrom
feat/docs-versions-skills-and-packages
Closed

kieronlanning wants to merge 3 commits into
mainfrom
feat/docs-versions-skills-and-packages

Conversation

@kieronlanning

Copy link
Copy Markdown
Contributor

No description provided.

…listing

Documentation versions are first-class: each channel gets its own sidebar topic (`<Project> <version>`), its own `/projects/<id>[/<channel>]/llms*.txt` bundles, and its own `discover.json` entry (`docsChannels`, schema 2). Bundles name their version and cross-link the others; no corpus mixes two versions.

Skills: descriptions are parsed from YAML (inline or `>-`), every package manager (npx/bunx/pnpm dlx/yarn dlx) is offered as copyable Expressive Code, and the standalone `/skills/` list moved onto the project pages (with a `/projects/` redirect). `/skills.json` is schema 2.

Packages: add the new ZodSharp preview packages and stop folding release tags that predate a package, so a prerelease-only package is listed with an empty stable cell instead of an invented stable version.
pm-skills gained a fifteenth skill, which broke the built-output assertion that hard-coded fourteen. Compare skills.json with the mirror the build published, and keep the non-empty guard, so adding a skill is a data change rather than a CI failure.
…witcher

The sidebar had become one topic per documentation version, so a project with live and prerelease docs appeared twice and the topic list read as a flat set of versions. Each channel still contributes its own topic internally (the page list must match the version being read), but every topic now carries the project name and the picker collapses the duplicates. Versions appear only in the page switcher, which is shown only while two versions are published.
@kieronlanning

Copy link
Copy Markdown
Contributor Author

Closing as superseded: this branch carries no work of its own.

Its three commits are the pre-squash originals of what landed as #50 (63ebe96) and #51 (29bc514), and the tree is identical to main at #51:

git diff --stat 5d4c98b origin/feat/docs-versions-skills-and-packages   -> 55 files, 1769 insertions(+), 400 deletions(-)
git diff --stat 5d4c98b 29bc514                                          -> 55 files, 1769 insertions(+), 400 deletions(-)

The merge base is #49 (5d4c98b), so the diff against current main contains no additions of its own - only the removal of #52 (a docs folder as a URL path segment) and #53 (the nested docs sidebar). Merging it would revert both, which is why it reads as CONFLICTING.

No unique content, so the branch is deleted as well. Anything still wanted from docs versions, skills and packages is already on main via #50 and #51.

@kieronlanning
kieronlanning deleted the feat/docs-versions-skills-and-packages branch November 4, 2026 00:10
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