Commit Graph

4 Commits

Author SHA1 Message Date
Evan Rusackas
770a23242c docs: add ASF license header to admin_docs/index.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 11:41:27 -08:00
Evan Rusackas
8c28c6b474 docs: rename /docs to /user-docs for consistency
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>
2026-02-24 11:41:27 -08:00
Evan Rusackas
0fb7fc2721 docs: bifurcate documentation into user, admin, and developer sections
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>
2026-02-24 11:41:27 -08:00
Evan Rusackas
a10d71a192 docs: fix internal links and add user-facing SQL templating guide
- 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>
2026-02-24 11:41:26 -08:00