- Replace all /developer_portal/ links with /developer-docs/ in index.md
- Fix non-existent extension-project-structure references
- Fix sidebar links using old /docs/ paths (/user-docs/ instead)
- Add missing extension-points/editors and pkg-resources-migration to sidebar
- Restore Kubernetes debugging section lost during howtos migration
- Restore pkg-resources-migration.md deleted during bifurcation
- Fix versioned docs quickstart.mdx missing version prefix
- Update stale developer_portal references in README, DOCS_CLAUDE, intro.md
- Fix broken creating-viz-plugins link in intro.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Rename the user documentation URL path from /docs to /user-docs to match
the naming convention of /admin-docs and /developer-docs.
Changes:
- Add routeBasePath: 'user-docs' to preset-classic docs config
- Add createRedirects for /docs/* → /user-docs/* pattern-based redirects
- Update all redirect destinations from /docs/* to /user-docs/*
- Update navbar links to use /user-docs/
- Update sitemap priorities to use /user-docs/
- Update internal links in user docs, admin docs, and developer docs
- Update footer security link to /admin-docs/security/
All old /docs/* URLs will automatically redirect to /user-docs/* via
the createRedirects function. Versioned docs at /docs/6.0.0/* remain
unchanged.
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Major restructuring of documentation to separate concerns:
**New Structure:**
- `/docs/` - User-facing docs (intro, quickstart, databases, using-superset, faq)
- `/admin-docs/` - Administrator docs (installation, configuration, security)
- `/developer-docs/` - Developer docs (contributing, extensions, guidelines, testing)
**Changes:**
- Move installation, configuration, and security docs to admin_docs/
- Move contributing, extensions, guidelines, and testing to developer_docs/
- Rename developer_portal to developer_docs (with underscore to hyphen in URL)
- Add sidebarAdminDocs.js for admin documentation navigation
- Update versions-config.json with new doc sections
- Update docusaurus.config.ts with new plugins and redirects
- Update internal links in versioned docs (6.0.0) to use new paths
- Keep user-facing content (databases, using-superset, faq) in main docs
This separation makes it clearer which documentation is relevant for:
- End users exploring and visualizing data
- Administrators deploying and configuring Superset
- Developers contributing to or extending Superset
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
- Fix broken links in quickstart.mdx pointing to old /docs/installation
and /docs/configuration paths, now redirecting to /admin-docs/
- Fix broken links in faq.mdx for installation, configuration, and
contributing paths
- Fix link in generate-database-docs.mjs for auto-generated database
index page
- Add new user-facing SQL templating guide in using-superset/ that
covers practical usage of Jinja templates in SQL Lab
- Add cross-link tip in admin SQL templating config guide pointing
users to the new user guide
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Add redirects for old /docs/ paths that were moved to /admin-docs/ or
/developer-docs/:
Configuration:
- /docs/configuration/country-map-tools
- /docs/configuration/importing-exporting-datasources
- /docs/configuration/map-tiles
- /docs/configuration/networking-settings
- /docs/configuration/timezones
Security:
- /docs/security/cves
- /docs/security/securing_superset
Contributing:
- /docs/contributing/resources
- /docs/contributing/misc
- /docs/contributing/pkg-resources-migration
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
