Commit Graph

7 Commits

Author SHA1 Message Date
Evan Rusackas
c151cc7200 docs: fix database logos on overview page, rename Developer Portal
- Fix 61 broken database logo images by updating paths from
  docs/static/img/ to /img/ (Docusaurus serves static/ at root)
- Update all old superset.apache.org/docs/ links to new bifurcated
  paths (user-docs, admin-docs, developer-docs)
- Rename "Developer Portal" to "Developer Docs" in user-facing pages

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 20:31:13 -08:00
Evan Rusackas
1008a5a364 docs: consistent overview URLs, README revamp, homepage card polish
- Rename user-docs/intro to user-docs/ for consistent section landing
  pages (matching admin-docs/ and developer-docs/)
- Add redirect from /user-docs/intro for existing bookmarks
- Revamp README with Documentation header and three section links,
  condense quick-links row
- Remove emojis from homepage cards and developer-docs overview
- Widen subtitle container to prevent line wrap on homepage
- Fix Contributor Guide link to developer-docs/

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-25 17:43:06 -08:00
Evan Rusackas
43a7138b73 docs: move API reference to developer docs, add active nav state, remove package-lock.json
- Move API reference from user-docs to developer-docs section:
  - Change OpenAPI plugin docsPluginId from 'classic' to 'developer_docs'
  - Move api.mdx and update outputDir to developer_docs/api
  - Update all three API generation scripts to use new paths
  - Update sidebars, navbar items, and redirect targets
  - Add redirect from /user-docs/api to /developer-docs/api
  - Update .gitignore for new generated API path

- Add activeBaseRegex to navbar dropdowns so the active section
  highlights when browsing sub-pages (Users, Admins, Developers,
  Community)

- Fix dropdown active link styling to use primary color instead
  of being invisible (transparent)

- Remove accidental empty package-lock.json from repo root
  (added in SIP-32, 2019)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-25 16:16:05 -08:00
Evan Rusackas
ff9acbf617 docs: fix default imports to named imports in component docs
These auto-generated component docs had default imports from
'@superset/components' which only exposes named exports. Fixed
Slider, Tree, ProgressBar, TableCollection, and Tabs.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-24 11:41:27 -08:00
Evan Rusackas
8ddb06bb2f docs: fix broken links, missing sidebar entries, and restore lost content
- 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>
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