RobotWebTools / rclnodejs / 28153524004

91%

push

github

[Docs] Rebuild JSDoc site as a pure function of manifest + git tags (#1553)

Replace the gh-pages branch cache with a stateless build so the published documentation site is fully reproducible from a curated manifest and the Git release tags. Every deploy rebuilds the complete site from scratch, so there is no branch state that can drift.

- Add tools/jsdoc/published-versions.json: a curated manifest (30 versions) that is the single source of truth for which versions are published.
- Rewrite tools/jsdoc/regenerate-published-docs.js as one linear build path: every manifest version is rebuilt from its Git release tag via `git worktree` + jsdoc (using the current template, so all versions render consistently), shared assets are hoisted to docs/_static, and the landing index is regenerated. Drop the gh-pages cache, prune/self-heal logic, the per-version asset copies, and all the old mode flags. Remaining flags: --out, --manifest (both now validate that a value follows the flag).
- package.json: replace `docs:gh-pages` / `docs:gh-pages:full` with a single `docs:publish` script.
- .github/workflows/deploy-docs.yml: set `contents: read`, remove the gh-pages fetch and write-back steps, run `npm run docs:publish`, and upload build/published-docs as the Pages artifact.
- tools/jsdoc/README.md: document the stateless manifest + tags model and the new naming; drop the obsolete "Recovering a Dropped Version" section and redundant gh-pages references.

Fix: #1552

2132 of 2509 branches covered (84.97%)

Branch coverage included in aggregate %.

17057 of 18554 relevant lines covered (91.93%)

222.31 hits per line