superset2

mirror of https://github.com/apache/superset.git synced 2026-05-23 16:55:19 +00:00

Files

Claude Code b4a0439756 chore(docs): refresh auto-gen before cut, delete empty versions.json on remove

Two related fixes to make the version cut self-contained and to clean
up after itself.

1. addVersion now runs `generate:smart` before snapshotting, so the
   versioned copy captures fresh database pages (from engine spec
   metadata), API reference (from openapi.json), and component pages
   (from Storybook stories) rather than whatever happened to be on
   disk. Added a --skip-generate flag for canonical release cuts where
   the operator has placed the `database-diagnostics` artifact from a
   green Python-Integration CI run at docs/src/data/databases.json and
   wants to preserve the full Flask-context diagnostics rather than
   regenerate locally.

2. removeVersion previously left an empty `<section>_versions.json`
   file (`[]`) on disk when removing the last version. Docusaurus
   would then snapshot that empty file back into content directories
   on the next cut. (This is how the orphan files this PR already
   cleans up — docs/components/versions.json and
   docs/developer_docs/versions.json — got accidentally tracked.) The
   remove path now deletes the file when it becomes empty.

Documented the cut prerequisites in docs/README.md ("Before You Cut")
and docs/DOCS_CLAUDE.md.

2026-05-13 17:15:29 -07:00

convert-api-sidebar.mjs

docs: bifurcate documentation into user and admin sections (#38196 )

2026-02-26 13:29:08 -08:00

extract_custom_errors.py

feat(docs): add auto-generated troubleshooting section to database pages (#37345 )

2026-01-22 14:43:02 -08:00

fix-openapi-spec.py

docs(api): add Theme API endpoints to OpenAPI spec (#37943 )

2026-04-10 00:17:06 -07:00

generate-api-index.mjs

fix(docs): use absolute API doc links in developer docs (#38649 )