This is an automated email from the ASF dual-hosted git repository.
rusackas pushed a commit to branch bifurcating_user_admin_docs
in repository https://gitbox.apache.org/repos/asf/superset.git
The following commit(s) were added to refs/heads/bifurcating_user_admin_docs by
this push:
new 78a9f9a7ecd docs: fix broken links, missing sidebar entries, and
restore lost content
78a9f9a7ecd is described below
commit 78a9f9a7ecd8bf0a5c4e97a245fc450d4eaba6c7
Author: Evan Rusackas <[email protected]>
AuthorDate: Mon Feb 23 11:21:21 2026 -0800
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 <[email protected]>
---
docs/.claude/instructions.md | 2 +-
docs/DOCS_CLAUDE.md | 2 +-
docs/README.md | 9 +-
.../contributing/development-setup.md | 2 +-
docs/developer_docs/contributing/howtos.md | 24 ++
.../contributing/pkg-resources-migration.md | 94 ++++++++
docs/developer_docs/contributing/resources.md | 4 +-
docs/developer_docs/index.md | 28 +--
docs/docs/intro.md | 257 +++++++++++++++++++++
docs/sidebarAdminDocs.js | 2 +-
docs/sidebarTutorials.js | 4 +-
docs/versioned_docs/version-6.0.0/intro.md | 2 +-
docs/versioned_docs/version-6.0.0/quickstart.mdx | 2 +-
13 files changed, 405 insertions(+), 27 deletions(-)
diff --git a/docs/.claude/instructions.md b/docs/.claude/instructions.md
index 54db2f6f121..4e3b5ccd538 100644
--- a/docs/.claude/instructions.md
+++ b/docs/.claude/instructions.md
@@ -111,5 +111,5 @@ InteractiveMenu.parameters = {
- **Generator**: `docs/scripts/generate-superset-components.mjs`
- **Wrapper**: `docs/src/components/StorybookWrapper.jsx`
-- **Output**: `docs/developer_portal/components/`
+- **Output**: `docs/developer_docs/components/`
- **Stories**: `superset-frontend/packages/superset-ui-core/src/components/*/`
diff --git a/docs/DOCS_CLAUDE.md b/docs/DOCS_CLAUDE.md
index 039b701ba1d..1ac49462afe 100644
--- a/docs/DOCS_CLAUDE.md
+++ b/docs/DOCS_CLAUDE.md
@@ -416,7 +416,7 @@ If versions don't appear in dropdown:
- [Docusaurus Documentation](https://docusaurus.io/docs)
- [MDX Documentation](https://mdxjs.com/)
-- [Superset Developer Portal](https://superset.apache.org/developer_portal/)
+- [Superset Developer Docs](https://superset.apache.org/developer-docs/)
- [Main Superset Documentation](https://superset.apache.org/docs/intro)
## 📖 Real Examples and Patterns
diff --git a/docs/README.md b/docs/README.md
index dbf7a51238b..6f3a6b4902e 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -19,15 +19,16 @@ under the License.
This is the public documentation site for Superset, built using
[Docusaurus 3](https://docusaurus.io/). See the
-[Developer
Portal](https://superset.apache.org/developer_portal/contributing/development-setup#documentation)
+[Developer
Docs](https://superset.apache.org/developer-docs/contributing/development-setup#documentation)
for documentation on contributing to documentation.
## Version Management
-The Superset documentation site uses Docusaurus versioning with three
independent versioned sections:
+The Superset documentation site uses Docusaurus versioning with four
independent sections:
-- **Main Documentation** (`/docs/`) - Core Superset documentation
-- **Developer Portal** (`/developer_portal/`) - Developer guides and tutorials
+- **User Documentation** (`/user-docs/`) - End-user guides and tutorials
+- **Admin Documentation** (`/admin-docs/`) - Installation, configuration, and
security
+- **Developer Docs** (`/developer-docs/`) - Developer guides, contributing,
and extensions
- **Component Playground** (`/components/`) - Interactive component examples
(currently disabled)
Each section maintains its own version history and can be versioned
independently.
diff --git a/docs/developer_docs/contributing/development-setup.md
b/docs/developer_docs/contributing/development-setup.md
index 44ff39ada47..dc1e9c4ed17 100644
--- a/docs/developer_docs/contributing/development-setup.md
+++ b/docs/developer_docs/contributing/development-setup.md
@@ -1012,7 +1012,7 @@ When contributing new React components to Superset,
please try to add a Story al
The topic of authoring new plugins, whether you'd like to contribute
it back or not has been well documented in the
-[the
documentation](https://superset.apache.org/docs/contributing/creating-viz-plugins),
and in [this blog
post](https://preset.io/blog/building-custom-viz-plugins-in-superset-v2).
+[the
documentation](/developer-docs/contributing/howtos#creating-visualization-plugins),
and in [this blog
post](https://preset.io/blog/building-custom-viz-plugins-in-superset-v2).
To contribute a plugin to Superset, your plugin must meet the following
criteria:
diff --git a/docs/developer_docs/contributing/howtos.md
b/docs/developer_docs/contributing/howtos.md
index e4469dfb07a..e01d54de334 100644
--- a/docs/developer_docs/contributing/howtos.md
+++ b/docs/developer_docs/contributing/howtos.md
@@ -256,6 +256,30 @@ For debugging the Flask backend:
2. Set breakpoints and press F5 to debug
+### Debugging Server App in Kubernetes Environment
+
+To debug Flask running in a POD inside a kubernetes cluster, you'll need to
make sure the pod runs as root and is granted the `SYS_PTRACE` capability.
These settings should not be used in production environments.
+
+```yaml
+ securityContext:
+ capabilities:
+ add: ["SYS_PTRACE"]
+```
+
+See [set capabilities for a
container](https://kubernetes.io/docs/tasks/configure-pod-container/security-context/#set-capabilities-for-a-container)
for more details.
+
+Once the pod is running as root and has the `SYS_PTRACE` capability it will be
able to debug the Flask app.
+
+You can follow the same instructions as in `docker compose`. Enter the pod and
install the required library and packages: gdb, netstat and debugpy.
+
+Often in a Kubernetes environment nodes are not addressable from outside the
cluster. VSCode will thus be unable to remotely connect to port 5678 on a
Kubernetes node. In order to do this you need to create a tunnel that port
forwards 5678 to your local machine.
+
+```bash
+kubectl port-forward pod/superset-<some random id> 5678:5678
+```
+
+You can now launch your VSCode debugger with the same config as above. VSCode
will connect to 127.0.0.1:5678 which is forwarded by kubectl to your remote
kubernetes POD.
+
### Storybook
See the dedicated [Storybook documentation](../testing/storybook) for
information on running Storybook locally and adding new stories.
diff --git a/docs/developer_docs/contributing/pkg-resources-migration.md
b/docs/developer_docs/contributing/pkg-resources-migration.md
new file mode 100644
index 00000000000..7300b14bc42
--- /dev/null
+++ b/docs/developer_docs/contributing/pkg-resources-migration.md
@@ -0,0 +1,94 @@
+---
+title: pkg_resources Migration Guide
+sidebar_position: 9
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# pkg_resources Deprecation and Migration Guide
+
+## Background
+
+As of setuptools 81.0.0, the `pkg_resources` API is deprecated and will be
removed. This affects several packages in the Python ecosystem.
+
+## Current Status
+
+### Superset Codebase
+
+The Superset codebase has already migrated away from `pkg_resources` to the
modern `importlib.metadata` API:
+
+- `superset/db_engine_specs/__init__.py` - Uses `from importlib.metadata
import entry_points`
+- All entry point loading uses the modern API
+
+### Production Dependencies
+
+Some third-party dependencies may still use `pkg_resources`. Monitor your
dependency tree for packages that haven't migrated yet.
+
+## Migration Path
+
+### Short-term Solution
+
+Pin setuptools to version 80.x to prevent breaking changes:
+
+```python
+# requirements/base.in
+setuptools<81
+```
+
+This prevents the removal of `pkg_resources` while dependent packages are
updated.
+
+### Long-term Solution
+
+Update all dependencies to use `importlib.metadata` instead of `pkg_resources`:
+
+#### Migration Example
+
+**Old (deprecated):**
+```python
+import pkg_resources
+
+version = pkg_resources.get_distribution("package_name").version
+entry_points = pkg_resources.iter_entry_points("group_name")
+```
+
+**New (recommended):**
+```python
+from importlib.metadata import version, entry_points
+
+pkg_version = version("package_name")
+eps = entry_points(group="group_name")
+```
+
+## Action Items
+
+### For Superset Maintainers
+1. The Superset codebase already uses `importlib.metadata`
+2. Monitor third-party dependencies for updates
+3. Update setuptools pin once the ecosystem is ready
+
+### For Extension Developers
+1. **Update your packages** to use `importlib.metadata` instead of
`pkg_resources`
+2. **Test with setuptools >= 81.0.0** once all packages are migrated
+
+## References
+
+- [setuptools pkg_resources deprecation
notice](https://setuptools.pypa.io/en/latest/pkg_resources.html)
+- [importlib.metadata
documentation](https://docs.python.org/3/library/importlib.metadata.html)
+- [Migration
guide](https://setuptools.pypa.io/en/latest/deprecated/pkg_resources.html)
diff --git a/docs/developer_docs/contributing/resources.md
b/docs/developer_docs/contributing/resources.md
index 78af327ae07..bd159c984f0 100644
--- a/docs/developer_docs/contributing/resources.md
+++ b/docs/developer_docs/contributing/resources.md
@@ -110,7 +110,7 @@ flowchart TD
## Entity-Relationship Diagram
-For the full interactive Entity-Relationship Diagram, please visit the [main
documentation](https://superset.apache.org/docs/contributing/resources).
+For the full interactive Entity-Relationship Diagram, please visit the
[developer documentation](/developer-docs/contributing/resources).
You can also [download the
.svg](https://github.com/apache/superset/tree/master/docs/static/img/erd.svg)
directly from GitHub.
@@ -119,7 +119,7 @@ You can also [download the
.svg](https://github.com/apache/superset/tree/master/
### Official Documentation
- [Apache Superset Documentation](https://superset.apache.org/docs/intro)
- [API Documentation](https://superset.apache.org/docs/api)
-- [Configuration
Guide](https://superset.apache.org/docs/installation/configuring-superset)
+- [Configuration
Guide](https://superset.apache.org/admin-docs/configuration/configuring-superset)
### Community Resources
- [Apache Superset Blog](https://preset.io/blog/)
diff --git a/docs/developer_docs/index.md b/docs/developer_docs/index.md
index fe567fcc5a9..b883a08d6b6 100644
--- a/docs/developer_docs/index.md
+++ b/docs/developer_docs/index.md
@@ -29,14 +29,14 @@ Welcome to the Apache Superset Developer Portal - your
comprehensive resource fo
## 🚀 Quick Start
### New Contributors
-- [Contributing Overview](/developer_portal/contributing/overview)
-- [Development Setup](/developer_portal/contributing/development-setup)
-- [Your First PR](/developer_portal/contributing/submitting-pr)
+- [Contributing Overview](/developer-docs/contributing/overview)
+- [Development Setup](/developer-docs/contributing/development-setup)
+- [Your First PR](/developer-docs/contributing/submitting-pr)
### Extension Development
-- [Extension Project
Structure](/developer_portal/extensions/extension-project-structure)
-- [Extension Architecture](/developer_portal/extensions/architecture)
-- [Quick Start](/developer_portal/extensions/quick-start)
+- [Extension Development](/developer-docs/extensions/development)
+- [Extension Architecture](/developer-docs/extensions/architecture)
+- [Quick Start](/developer-docs/extensions/quick-start)
## 📚 Documentation Sections
@@ -83,7 +83,7 @@ Everything you need to contribute to the Apache Superset
project. This section i
### External Documentation
- **[User Documentation](https://superset.apache.org/docs/intro)** - Using
Superset
- **[API Documentation](https://superset.apache.org/docs/api)** - REST API
reference
-- **[Configuration
Guide](https://superset.apache.org/docs/configuration/configuring-superset)** -
Setup and configuration
+- **[Configuration
Guide](https://superset.apache.org/admin-docs/configuration/configuring-superset)**
- Setup and configuration
### Important Files
- **[CLAUDE.md](https://github.com/apache/superset/blob/master/CLAUDE.md)** -
LLM development guide
@@ -96,17 +96,17 @@ Everything you need to contribute to the Apache Superset
project. This section i
<td width="50%">
**I want to contribute code**
-1. [Set up development
environment](/developer_portal/contributing/development-setup)
+1. [Set up development
environment](/developer-docs/contributing/development-setup)
2. [Find a good first
issue](https://github.com/apache/superset/labels/good%20first%20issue)
-3. [Submit your first PR](/developer_portal/contributing/submitting-pr)
+3. [Submit your first PR](/developer-docs/contributing/submitting-pr)
</td>
<td width="50%">
**I want to build an extension**
-1. [Start with Quick Start](/developer_portal/extensions/quick-start)
-2. [Learn extension
structure](/developer_portal/extensions/extension-project-structure)
-3. [Explore architecture](/developer_portal/extensions/architecture)
+1. [Start with Quick Start](/developer-docs/extensions/quick-start)
+2. [Learn extension development](/developer-docs/extensions/development)
+3. [Explore architecture](/developer-docs/extensions/architecture)
</td>
</tr>
@@ -115,8 +115,8 @@ Everything you need to contribute to the Apache Superset
project. This section i
**I found a bug**
1. [Search existing issues](https://github.com/apache/superset/issues)
-2. [Report the bug](/developer_portal/contributing/issue-reporting)
-3. [Submit a fix](/developer_portal/contributing/submitting-pr)
+2. [Report the bug](/developer-docs/contributing/issue-reporting)
+3. [Submit a fix](/developer-docs/contributing/submitting-pr)
</td>
<td>
diff --git a/docs/docs/intro.md b/docs/docs/intro.md
new file mode 100644
index 00000000000..4921692e769
--- /dev/null
+++ b/docs/docs/intro.md
@@ -0,0 +1,257 @@
+---
+hide_title: true
+sidebar_position: 1
+---
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements. See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership. The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied. See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# Superset
+
+[](https://opensource.org/license/apache-2-0)
+[](https://github.com/apache/superset/releases/latest)
+[](https://github.com/apache/superset/actions)
+[](https://badge.fury.io/py/apache_superset)
+[](https://pypi.python.org/pypi/apache_superset)
+[](https://github.com/apache/superset/stargazers)
+[](https://github.com/apache/superset/graphs/contributors)
+[](https://github.com/apache/superset/commits/master)
+[](https://github.com/apache/superset/issues)
+[](https://github.com/apache/superset/pulls)
+[](http://bit.ly/join-superset-slack)
+[](https://superset.apache.org)
+
+<picture width="500">
+ <source
+ width="600"
+ media="(prefers-color-scheme: dark)"
+ src="https://superset.apache.org/img/superset-logo-horiz-dark.svg";
+ alt="Superset logo (dark)"
+ />
+ <img
+ width="600"
+ src="https://superset.apache.org/img/superset-logo-horiz-apache.svg";
+ alt="Superset logo (light)"
+ />
+</picture>
+
+A modern, enterprise-ready business intelligence web application.
+
+[**Why Superset?**](#why-superset) |
+[**Supported Databases**](#supported-databases) |
+[**Installation and Configuration**](#installation-and-configuration) |
+[**Release
Notes**](https://github.com/apache/superset/blob/master/RELEASING/README.md#release-notes-for-recent-releases)
|
+[**Get Involved**](#get-involved) |
+[**Contributor Guide**](#contributor-guide) |
+[**Resources**](#resources) |
+[**Organizations Using Superset**](https://superset.apache.org/inTheWild)
+
+## Why Superset?
+
+Superset is a modern data exploration and data visualization platform.
Superset can replace or augment proprietary business intelligence tools for
many teams. Superset integrates well with a variety of data sources.
+
+Superset provides:
+
+- A **no-code interface** for building charts quickly
+- A powerful, web-based **SQL Editor** for advanced querying
+- A **lightweight semantic layer** for quickly defining custom dimensions and
metrics
+- Out of the box support for **nearly any SQL** database or data engine
+- A wide array of **beautiful visualizations** to showcase your data, ranging
from simple bar charts to geospatial visualizations
+- Lightweight, configurable **caching layer** to help ease database load
+- Highly extensible **security roles and authentication** options
+- An **API** for programmatic customization
+- A **cloud-native architecture** designed from the ground up for scale
+
+## Screenshots & Gifs
+
+**Video Overview**
+
+<!-- File hosted here
https://github.com/apache/superset-site/raw/lfs/superset-video-4k.mp4 -->
+
+[superset-video-1080p.webm](https://github.com/user-attachments/assets/b37388f7-a971-409c-96a7-90c4e31322e6)
+
+<br/>
+
+**Large Gallery of Visualizations**
+
+<kbd><img title="Gallery"
src="https://superset.apache.org/img/screenshots/gallery.jpg"/></kbd><br/>
+
+**Craft Beautiful, Dynamic Dashboards**
+
+<kbd><img title="View Dashboards"
src="https://superset.apache.org/img/screenshots/dashboard.jpg"/></kbd><br/>
+
+**No-Code Chart Builder**
+
+<kbd><img title="Slice & dice your data"
src="https://superset.apache.org/img/screenshots/explore.jpg"/></kbd><br/>
+
+**Powerful SQL Editor**
+
+<kbd><img title="SQL Lab"
src="https://superset.apache.org/img/screenshots/sql_lab.jpg"/></kbd><br/>
+
+## Supported Databases
+
+Superset can query data from any SQL-speaking datastore or data engine
(Presto, Trino, Athena, [and more](https://superset.apache.org/docs/databases))
that has a Python DB-API driver and a SQLAlchemy dialect.
+
+Here are some of the major database solutions that are supported:
+
+<!-- SUPPORTED_DATABASES_START -->
+<p align="center">
+ <a href="https://superset.apache.org/docs/databases/supported/amazon-athena";
title="Amazon Athena"><img src="docs/static/img/databases/amazon-athena.jpg"
alt="Amazon Athena" width="76" height="40" /></a>
+ <a
href="https://superset.apache.org/docs/databases/supported/amazon-dynamodb";
title="Amazon DynamoDB"><img src="docs/static/img/databases/aws.png"
alt="Amazon DynamoDB" width="40" height="40" /></a>
+ <a
href="https://superset.apache.org/docs/databases/supported/amazon-redshift";
title="Amazon Redshift"><img src="docs/static/img/databases/redshift.png"
alt="Amazon Redshift" width="100" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/apache-doris";
title="Apache Doris"><img src="docs/static/img/databases/doris.png" alt="Apache
Doris" width="103" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/apache-drill";
title="Apache Drill"><img src="docs/static/img/databases/apache-drill.png"
alt="Apache Drill" width="81" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/apache-druid";
title="Apache Druid"><img src="docs/static/img/databases/druid.png" alt="Apache
Druid" width="117" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/apache-hive";
title="Apache Hive"><img src="docs/static/img/databases/apache-hive.svg"
alt="Apache Hive" width="44" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/apache-impala";
title="Apache Impala"><img src="docs/static/img/databases/apache-impala.png"
alt="Apache Impala" width="21" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/apache-kylin";
title="Apache Kylin"><img src="docs/static/img/databases/apache-kylin.png"
alt="Apache Kylin" width="44" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/apache-pinot";
title="Apache Pinot"><img src="docs/static/img/databases/apache-pinot.svg"
alt="Apache Pinot" width="76" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/apache-solr";
title="Apache Solr"><img src="docs/static/img/databases/apache-solr.png"
alt="Apache Solr" width="79" height="40" /></a>
+ <a
href="https://superset.apache.org/docs/databases/supported/apache-spark-sql";
title="Apache Spark SQL"><img src="docs/static/img/databases/apache-spark.png"
alt="Apache Spark SQL" width="75" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/ascend";
title="Ascend"><img src="docs/static/img/databases/ascend.webp" alt="Ascend"
width="117" height="40" /></a>
+ <a
href="https://superset.apache.org/docs/databases/supported/aurora-mysql-data-api";
title="Aurora MySQL (Data API)"><img src="docs/static/img/databases/mysql.png"
alt="Aurora MySQL (Data API)" width="77" height="40" /></a>
+ <a
href="https://superset.apache.org/docs/databases/supported/aurora-postgresql-data-api";
title="Aurora PostgreSQL (Data API)"><img
src="docs/static/img/databases/postgresql.svg" alt="Aurora PostgreSQL (Data
API)" width="76" height="40" /></a>
+ <a
href="https://superset.apache.org/docs/databases/supported/azure-data-explorer";
title="Azure Data Explorer"><img src="docs/static/img/databases/kusto.png"
alt="Azure Data Explorer" width="40" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/azure-synapse";
title="Azure Synapse"><img src="docs/static/img/databases/azure.svg" alt="Azure
Synapse" width="40" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/clickhouse";
title="ClickHouse"><img src="docs/static/img/databases/clickhouse.png"
alt="ClickHouse" width="150" height="37" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/cloudflare-d1";
title="Cloudflare D1"><img src="docs/static/img/databases/cloudflare.png"
alt="Cloudflare D1" width="40" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/cockroachdb";
title="CockroachDB"><img src="docs/static/img/databases/cockroachdb.png"
alt="CockroachDB" width="150" height="24" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/couchbase";
title="Couchbase"><img src="docs/static/img/databases/couchbase.svg"
alt="Couchbase" width="150" height="35" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/cratedb";
title="CrateDB"><img src="docs/static/img/databases/cratedb.svg" alt="CrateDB"
width="180" height="24" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/databend";
title="Databend"><img src="docs/static/img/databases/databend.png"
alt="Databend" width="100" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/databricks";
title="Databricks"><img src="docs/static/img/databases/databricks.png"
alt="Databricks" width="152" height="24" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/denodo";
title="Denodo"><img src="docs/static/img/databases/denodo.png" alt="Denodo"
width="138" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/dremio";
title="Dremio"><img src="docs/static/img/databases/dremio.png" alt="Dremio"
width="126" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/duckdb";
title="DuckDB"><img src="docs/static/img/databases/duckdb.png" alt="DuckDB"
width="52" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/elasticsearch";
title="Elasticsearch"><img src="docs/static/img/databases/elasticsearch.png"
alt="Elasticsearch" width="40" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/exasol";
title="Exasol"><img src="docs/static/img/databases/exasol.png" alt="Exasol"
width="72" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/firebird";
title="Firebird"><img src="docs/static/img/databases/firebird.png"
alt="Firebird" width="100" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/firebolt";
title="Firebolt"><img src="docs/static/img/databases/firebolt.png"
alt="Firebolt" width="100" height="40" /></a>
+ <a
href="https://superset.apache.org/docs/databases/supported/google-bigquery";
title="Google BigQuery"><img
src="docs/static/img/databases/google-big-query.svg" alt="Google BigQuery"
width="76" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/google-sheets";
title="Google Sheets"><img src="docs/static/img/databases/google-sheets.svg"
alt="Google Sheets" width="76" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/greenplum";
title="Greenplum"><img src="docs/static/img/databases/greenplum.png"
alt="Greenplum" width="124" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/hologres";
title="Hologres"><img src="docs/static/img/databases/hologres.png"
alt="Hologres" width="44" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/ibm-db2";
title="IBM Db2"><img src="docs/static/img/databases/ibm-db2.svg" alt="IBM Db2"
width="91" height="40" /></a>
+ <a
href="https://superset.apache.org/docs/databases/supported/ibm-netezza-performance-server";
title="IBM Netezza Performance Server"><img
src="docs/static/img/databases/netezza.png" alt="IBM Netezza Performance
Server" width="40" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/mariadb";
title="MariaDB"><img src="docs/static/img/databases/mariadb.png" alt="MariaDB"
width="150" height="37" /></a>
+ <a
href="https://superset.apache.org/docs/databases/supported/microsoft-sql-server";
title="Microsoft SQL Server"><img src="docs/static/img/databases/msql.png"
alt="Microsoft SQL Server" width="50" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/monetdb";
title="MonetDB"><img src="docs/static/img/databases/monet-db.png" alt="MonetDB"
width="100" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/mongodb";
title="MongoDB"><img src="docs/static/img/databases/mongodb.png" alt="MongoDB"
width="150" height="38" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/motherduck";
title="MotherDuck"><img src="docs/static/img/databases/motherduck.png"
alt="MotherDuck" width="40" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/oceanbase";
title="OceanBase"><img src="docs/static/img/databases/oceanbase.svg"
alt="OceanBase" width="175" height="24" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/oracle";
title="Oracle"><img src="docs/static/img/databases/oraclelogo.png" alt="Oracle"
width="111" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/presto";
title="Presto"><img src="docs/static/img/databases/presto-og.png" alt="Presto"
width="127" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/risingwave";
title="RisingWave"><img src="docs/static/img/databases/risingwave.svg"
alt="RisingWave" width="147" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/sap-hana";
title="SAP HANA"><img src="docs/static/img/databases/sap-hana.png" alt="SAP
HANA" width="137" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/sap-sybase";
title="SAP Sybase"><img src="docs/static/img/databases/sybase.png" alt="SAP
Sybase" width="100" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/shillelagh";
title="Shillelagh"><img src="docs/static/img/databases/shillelagh.png"
alt="Shillelagh" width="40" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/singlestore";
title="SingleStore"><img src="docs/static/img/databases/singlestore.png"
alt="SingleStore" width="150" height="31" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/snowflake";
title="Snowflake"><img src="docs/static/img/databases/snowflake.svg"
alt="Snowflake" width="76" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/sqlite";
title="SQLite"><img src="docs/static/img/databases/sqlite.png" alt="SQLite"
width="84" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/starrocks";
title="StarRocks"><img src="docs/static/img/databases/starrocks.png"
alt="StarRocks" width="149" height="40" /></a>
+ <a
href="https://superset.apache.org/docs/databases/supported/superset-meta-database";
title="Superset meta database"><img
src="docs/static/img/databases/superset.svg" alt="Superset meta database"
width="150" height="39" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/tdengine";
title="TDengine"><img src="docs/static/img/databases/tdengine.png"
alt="TDengine" width="140" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/teradata";
title="Teradata"><img src="docs/static/img/databases/teradata.png"
alt="Teradata" width="124" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/timescaledb";
title="TimescaleDB"><img src="docs/static/img/databases/timescale.png"
alt="TimescaleDB" width="150" height="36" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/trino";
title="Trino"><img src="docs/static/img/databases/trino.png" alt="Trino"
width="89" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/vertica";
title="Vertica"><img src="docs/static/img/databases/vertica.png" alt="Vertica"
width="128" height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/ydb";
title="YDB"><img src="docs/static/img/databases/ydb.svg" alt="YDB" width="110"
height="40" /></a>
+ <a href="https://superset.apache.org/docs/databases/supported/yugabytedb";
title="YugabyteDB"><img src="docs/static/img/databases/yugabyte.png"
alt="YugabyteDB" width="150" height="26" /></a>
+</p>
+<!-- SUPPORTED_DATABASES_END -->
+
+**A more comprehensive list of supported databases** along with the
configuration instructions can be found
[here](https://superset.apache.org/docs/databases).
+
+Want to add support for your datastore or data engine? Read more
[here](https://superset.apache.org/docs/frequently-asked-questions#does-superset-work-with-insert-database-engine-here)
about the technical requirements.
+
+## Installation and Configuration
+
+Try out Superset's [quickstart](https://superset.apache.org/docs/quickstart/)
guide or learn about [the options for production
deployments](https://superset.apache.org/docs/installation/architecture/).
+
+## Get Involved
+
+- Ask and answer questions on
[StackOverflow](https://stackoverflow.com/questions/tagged/apache-superset)
using the **apache-superset** tag
+- [Join our community's Slack](http://bit.ly/join-superset-slack)
+ and please read our [Slack Community
Guidelines](https://github.com/apache/superset/blob/master/CODE_OF_CONDUCT.md#slack-community-guidelines)
+- [Join our [email protected] Mailing
list](https://lists.apache.org/[email protected]). To join,
simply send an email to
[[email protected]](mailto:[email protected])
+- If you want to help troubleshoot GitHub Issues involving the numerous
database drivers that Superset supports, please consider adding your name and
the databases you have access to on the [Superset Database Familiarity
Rolodex](https://docs.google.com/spreadsheets/d/1U1qxiLvOX0kBTUGME1AHHi6Ywel6ECF8xk_Qy-V9R8c/edit#gid=0)
+- Join Superset's Town Hall and [Operational
Model](https://preset.io/blog/the-superset-operational-model-wants-you/)
recurring meetings. Meeting info is available on the [Superset Community
Calendar](https://superset.apache.org/community)
+
+## Contributor Guide
+
+Interested in contributing? Check out our
+[Developer Portal](https://superset.apache.org/developer-docs/)
+to find resources around contributing along with a detailed guide on
+how to set up a development environment.
+
+## Resources
+
+- [Superset "In the Wild"](https://superset.apache.org/inTheWild) - see who's
using Superset, and [add your
organization](https://github.com/apache/superset/edit/master/RESOURCES/INTHEWILD.yaml)
to the list!
+- [Feature
Flags](https://superset.apache.org/docs/configuration/feature-flags) - the
status of Superset's Feature Flags.
+- [Standard
Roles](https://github.com/apache/superset/blob/master/RESOURCES/STANDARD_ROLES.md)
- How RBAC permissions map to roles.
+- [Superset Wiki](https://github.com/apache/superset/wiki) - Tons of
additional community resources: best practices, community content and other
information.
+- [Superset SIPs](https://github.com/orgs/apache/projects/170) - The status of
Superset's SIPs (Superset Improvement Proposals) for both consensus and
implementation status.
+
+Understanding the Superset Points of View
+
+- [The Case for Dataset-Centric
Visualization](https://preset.io/blog/dataset-centric-visualization/)
+- [Understanding the Superset Semantic
Layer](https://preset.io/blog/understanding-superset-semantic-layer/)
+
+- Getting Started with Superset
+ - [Superset in 2 Minutes using Docker
Compose](https://superset.apache.org/docs/installation/docker-compose#installing-superset-locally-using-docker-compose)
+ - [Installing Database
Drivers](https://superset.apache.org/docs/configuration/databases#installing-database-drivers)
+ - [Building New Database
Connectors](https://preset.io/blog/building-database-connector/)
+ - [Create Your First
Dashboard](https://superset.apache.org/docs/using-superset/creating-your-first-dashboard/)
+ - [Comprehensive Tutorial for Contributing Code to Apache Superset
+ ](https://preset.io/blog/tutorial-contributing-code-to-apache-superset/)
+- [Resources to master Superset by Preset](https://preset.io/resources/)
+
+- Deploying Superset
+
+ - [Official Docker image](https://hub.docker.com/r/apache/superset)
+ - [Helm Chart](https://github.com/apache/superset/tree/master/helm/superset)
+
+- Recordings of Past [Superset Community Events](https://preset.io/events)
+
+ - [Mixed Time Series
Charts](https://preset.io/events/mixed-time-series-visualization-in-superset-workshop/)
+ - [How the Bing Team Customized Superset for the Internal Self-Serve Data &
Analytics
Platform](https://preset.io/events/how-the-bing-team-heavily-customized-superset-for-their-internal-data/)
+ - [Live Demo: Visualizing MongoDB and Pinot Data using
Trino](https://preset.io/events/2021-04-13-visualizing-mongodb-and-pinot-data-using-trino/)
+ - [Introduction to the Superset
API](https://preset.io/events/introduction-to-the-superset-api/)
+ - [Building a Database Connector for
Superset](https://preset.io/events/2021-02-16-building-a-database-connector-for-superset/)
+
+- Visualizations
+
+ - [Creating Viz
Plugins](https://superset.apache.org/developer-docs/contributing/howtos#creating-visualization-plugins)
+ - [Managing and Deploying Custom Viz
Plugins](https://medium.com/nmc-techblog/apache-superset-manage-custom-viz-plugins-in-production-9fde1a708e55)
+ - [Why Apache Superset is Betting on Apache
ECharts](https://preset.io/blog/2021-4-1-why-echarts/)
+
+- [Superset API](https://superset.apache.org/docs/rest-api)
+
+## Repo Activity
+
+<a
href="https://next.ossinsight.io/widgets/official/compose-last-28-days-stats?repo_id=39464018";
target="_blank" align="center">
+ <picture>
+ <source media="(prefers-color-scheme: dark)"
srcset="https://next.ossinsight.io/widgets/official/compose-last-28-days-stats/thumbnail.png?repo_id=39464018&image_size=auto&color_scheme=dark";
width="655" height="auto" />
+ <img alt="Performance Stats of apache/superset - Last 28 days"
src="https://next.ossinsight.io/widgets/official/compose-last-28-days-stats/thumbnail.png?repo_id=39464018&image_size=auto&color_scheme=light";
width="655" height="auto" />
+ </picture>
+</a>
+
+<!-- Made with [OSS Insight](https://ossinsight.io/) -->
+
+<!-- telemetry/analytics pixel: -->
+<img referrerpolicy="no-referrer-when-downgrade"
src="https://static.scarf.sh/a.png?x-pxid=bc1c90cd-bc04-4e11-8c7b-289fb2839492";
/>
diff --git a/docs/sidebarAdminDocs.js b/docs/sidebarAdminDocs.js
index 1acfaface7f..cf59bc1c1a2 100644
--- a/docs/sidebarAdminDocs.js
+++ b/docs/sidebarAdminDocs.js
@@ -53,7 +53,7 @@ const sidebars = {
{
type: 'link',
label: 'Database Drivers',
- href: '/docs/databases',
+ href: '/user-docs/databases',
description: 'See User Docs for database connection guides',
},
{
diff --git a/docs/sidebarTutorials.js b/docs/sidebarTutorials.js
index b786478c0b1..fbcf39d8dad 100644
--- a/docs/sidebarTutorials.js
+++ b/docs/sidebarTutorials.js
@@ -42,6 +42,7 @@ const sidebars = {
'contributing/howtos',
'contributing/release-process',
'contributing/resources',
+ 'contributing/pkg-resources-migration',
'guidelines/design-guidelines',
{
type: 'category',
@@ -91,6 +92,7 @@ const sidebars = {
collapsed: true,
items: [
'extensions/extension-points/sqllab',
+ 'extensions/extension-points/editors',
],
},
'extensions/development',
@@ -129,7 +131,7 @@ const sidebars = {
{
type: 'link',
label: 'API Reference',
- href: '/docs/api',
+ href: '/user-docs/api',
},
],
};
diff --git a/docs/versioned_docs/version-6.0.0/intro.md
b/docs/versioned_docs/version-6.0.0/intro.md
index b928eb7d8bb..841ee0f7e55 100644
--- a/docs/versioned_docs/version-6.0.0/intro.md
+++ b/docs/versioned_docs/version-6.0.0/intro.md
@@ -165,7 +165,7 @@ Try out Superset's
[quickstart](https://superset.apache.org/docs/quickstart/) gu
## Contributor Guide
Interested in contributing? Check out our
-[Developer Portal](https://superset.apache.org/developer_portal/)
+[Developer Docs](https://superset.apache.org/developer-docs/)
to find resources around contributing along with a detailed guide on
how to set up a development environment.
diff --git a/docs/versioned_docs/version-6.0.0/quickstart.mdx
b/docs/versioned_docs/version-6.0.0/quickstart.mdx
index b9795106b74..640ebe5794b 100644
--- a/docs/versioned_docs/version-6.0.0/quickstart.mdx
+++ b/docs/versioned_docs/version-6.0.0/quickstart.mdx
@@ -73,7 +73,7 @@ processes by running Docker Compose `stop` command. By doing
so, you can avoid d
From this point on, you can head on to:
-- [Create your first
Dashboard](/docs/using-superset/creating-your-first-dashboard)
+- [Create your first
Dashboard](/docs/6.0.0/using-superset/creating-your-first-dashboard)
- [Connect to a Database](/docs/6.0.0/configuration/databases)
- [Using Docker Compose](/docs/6.0.0/installation/docker-compose)
- [Configure Superset](/docs/6.0.0/configuration/configuring-superset/)
![https://superset.apache.org/img/superset-logo-horiz-dark.svg"](https://superset.apache.org/img/superset-logo-horiz-dark.svg"){kind=link}
![https://superset.apache.org/img/superset-logo-horiz-apache.svg"](https://superset.apache.org/img/superset-logo-horiz-apache.svg"){kind=link}
![https://superset.apache.org/img/screenshots/gallery.jpg"/](https://superset.apache.org/img/screenshots/gallery.jpg"/){kind=link}
![https://superset.apache.org/img/screenshots/dashboard.jpg"/](https://superset.apache.org/img/screenshots/dashboard.jpg"/){kind=link}
![https://superset.apache.org/img/screenshots/explore.jpg"/](https://superset.apache.org/img/screenshots/explore.jpg"/){kind=link}
![https://superset.apache.org/img/screenshots/sql_lab.jpg"/](https://superset.apache.org/img/screenshots/sql_lab.jpg"/){kind=link}
![https://next.ossinsight.io/widgets/official/compose-last-28-days-stats/thumbnail.png?repo_id=39464018&image_size=auto&color_scheme=dark"](https://next.ossinsight.io/widgets/official/compose-last-28-days-stats/thumbnail.png?repo_id=39464018&image_size=auto&color_scheme=dark"){kind=link}
![https://next.ossinsight.io/widgets/official/compose-last-28-days-stats/thumbnail.png?repo_id=39464018&image_size=auto&color_scheme=light"](https://next.ossinsight.io/widgets/official/compose-last-28-days-stats/thumbnail.png?repo_id=39464018&image_size=auto&color_scheme=light"){kind=link}
![https://static.scarf.sh/a.png?x-pxid=bc1c90cd-bc04-4e11-8c7b-289fb2839492"](https://static.scarf.sh/a.png?x-pxid=bc1c90cd-bc04-4e11-8c7b-289fb2839492"){kind=link}