rusackas opened a new pull request, #36756: URL: https://github.com/apache/superset/pull/36756
## Summary This PR consolidates scattered markdown documentation files from the repository root into the centralized Docusaurus docs site, establishing a single source of truth and eliminating duplicated/outdated content. ### Changes **1. CONTRIBUTING.md → Developer Portal redirect** - Converted to a minimal redirect stub pointing to the docs site - Updated 14 files that linked to CONTRIBUTING.md **2. INSTALL.md → Installation docs redirect** - Converted to redirect stub pointing to installation docs **3. UPDATING.md → Linked from upgrade docs** - Kept as active changelog (part of release process) - Added link from docs/installation/upgrading-superset.mdx **4. Linting docs consolidated** - Merged LINTING_ARCHITECTURE.md + superset-frontend/LINTING.md → developer_portal/howtos.md - Deleted both standalone files - Updated references to OXC (replacing ESLint) **5. Playwright README consolidated** - Moved superset-frontend/playwright/README.md → developer_portal/testing/e2e-testing.md - Deleted standalone README **6. FEATURE_FLAGS.md → Dynamic docs page** ⭐ - Annotated feature flags in `superset/config.py` with `@lifecycle`, `@docs`, `@category` - Created `scripts/extract_feature_flags.py` parser to extract metadata to JSON - Created `docs/docs/configuration/feature-flags.mdx` that dynamically renders the JSON - Deleted `RESOURCES/FEATURE_FLAGS.md` - Updated all references (10 files) ### Benefits - **Single source of truth**: Documentation lives in one place - **Auto-generated feature flags**: Docs stay in sync with code annotations - **Reduced maintenance**: No need to update multiple files - **Better discoverability**: Users find docs in one consistent location ## Test Plan - [ ] Verify docs site builds: `cd docs && npm run build` - [ ] Check feature flags page renders correctly - [ ] Verify all updated links work 🤖 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]
