rusackas opened a new pull request, #36761: URL: https://github.com/apache/superset/pull/36761
## Summary Adds a custom `:::resources` admonition to the Superset documentation for linking to external resources (vendor docs, blogs, tutorials, videos). This creates a consistent, subtle way to surface additional learning materials throughout the docs. **Changes include:** - Custom `ResourcesAdmonition` component with bookmark icon - Subtle gray styling (light/dark mode support) - Registration of `resources` keyword in Docusaurus config - 50+ external resources added across 15 documentation pages ### Resources Added | Page | Resources | |------|-----------| | **databases.mdx** | ClickHouse, CrateDB, Trino, YugabyteDB, Elasticsearch, BigQuery, Hive, Oracle, PostgreSQL, Snowflake, Spark SQL, TimescaleDB vendor docs & blogs | | **quickstart.mdx** | Superset 101 video, getting started blog | | **theming.mdx** | Theming video, CSS customization blogs | | **exploring-data.mdx** | ECharts, drill-by, cross-filtering blogs | | **creating-your-first-dashboard.mdx** | Dashboard best practices, semantic layer | | **configuring-superset.mdx** | Feature flags blog | | **securing_superset.mdx** | Security vulnerabilities handling blog | | **api.mdx** | REST API and accessing APIs blogs | | **alerts-reports.mdx** | Slack/email alerts tutorials | | **kubernetes.mdx** | Helm deployment tutorials | | **cache.mdx** | Performance optimization blogs | ## BEFORE/AFTER **Before:** No consistent way to link external resources **After:** Subtle gray box with bookmark icon: ``` ┌─────────────────────────────────────────────────┐ │ 🔖 Additional Resources │ │ │ │ • Video: Superset 101 │ │ • Blog: Getting Started with Apache Superset │ │ • Tutorial: Creating Your First Dashboard │ └─────────────────────────────────────────────────┘ ``` ## TESTING INSTRUCTIONS 1. Build docs: `cd docs && npm run build` 2. Serve: `npx serve build` 3. Check any page with resources (e.g., /docs/quickstart) 4. Verify gray styling in both light and dark mode ## ADDITIONAL INFORMATION - Sources include: Preset blogs, vendor documentation (ClickHouse, Trino, CrateDB, etc.), YouTube tutorials, and community blogs - All links verified as working and relevant to their respective documentation sections 🤖 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]
