rusackas opened a new pull request, #38196:
URL: https://github.com/apache/superset/pull/38196
### SUMMARY
Reorganizes the Superset documentation information architecture by splitting
the single "Documentation" section into four distinct sections:
- **User Docs** (`/user-docs/`) — End-user guides: quickstart, FAQ, creating
dashboards, database connections, SQL templating
- **Admin Docs** (`/admin-docs/`) — Installation, configuration, security
(moved from `/docs/configuration/`, `/docs/installation/`, `/docs/security/`)
- **Developer Docs** (`/developer-docs/`) — Contributing, extensions,
testing, guidelines, UI components (renamed from `/developer_portal/`)
- **Community** — Existing community pages (unchanged)
Key changes:
- Moved installation/configuration/security docs from `docs/docs/` to
`docs/admin_docs/`
- Renamed `developer_portal/` to `developer_docs/` with URL path
`/developer-docs/`
- Renamed user-facing docs URL from `/docs/` to `/user-docs/`
- Added comprehensive URL redirects for all old paths (`/docs/*` → new
locations, `/developer_portal/*` → `/developer-docs/*`)
- Added new user-facing SQL templating guide alongside the admin-level
config guide
- Updated all internal cross-references and sidebar links
- Updated versioned docs (v6.0.0) links with correct version prefixes
- Restored content lost during migration (Kubernetes debugging section,
pkg-resources migration guide)
- Added missing sidebar entries (extension-points/editors,
pkg-resources-migration)
- Updated README.md, DOCS_CLAUDE.md, and LLM instruction files to reflect
new structure
### BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF
N/A — documentation restructuring, no UI changes to the Superset application
itself.
### TESTING INSTRUCTIONS
1. Build the docs site locally:
```bash
cd docs
npm install
npm run build
```
2. Verify the four sections appear in the navbar (Users, Admins, Developers,
Community)
3. Verify old URLs redirect correctly:
- `/docs/configuration/configuring-superset` →
`/admin-docs/configuration/configuring-superset`
- `/docs/installation/kubernetes` → `/admin-docs/installation/kubernetes`
- `/developer_portal/contributing/overview` →
`/developer-docs/contributing/overview`
- `/docs/quickstart` → `/user-docs/intro`
4. Verify sidebar navigation works in all sections
5. Spot-check internal links in admin docs, developer docs, and user docs
### ADDITIONAL INFORMATION
- [ ] Has associated issue:
- [ ] Required feature flags:
- [ ] Changes UI
- [ ] Includes DB Migration (follow approval process in
[SIP-59](https://github.com/apache/superset/issues/13351))
- [ ] Migration is atomic, supports rollback & is backwards-compatible
- [ ] Confirm DB migration upgrade and downgrade tested
- [ ] Runtime estimates and downtime expectations provided
- [ ] Introduces new feature or API
- [ ] Removes existing feature or API
🤖 Generated with [Claude Code](https://claude.com/claude-code)
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
