apache · hughhhh · Jan 13, 2022
diff --git a/docs-v2/.gitignore b/docs-v2/.gitignore
diff --git a/docs-v2/.prettierrc b/docs-v2/.prettierrc
diff --git a/docs-v2/README.md b/docs-v2/README.md
diff --git a/docs-v2/package-lock.json b/docs-v2/package-lock.json
diff --git a/docs-v2/package.json b/docs-v2/package.json
diff --git a/docs-v2/src/pages/index.tsx b/docs-v2/src/pages/index.tsx
diff --git a/docs/.asf.yaml b/docs/.asf.yaml
diff --git a/docs/.eslintrc.js b/docs/.eslintrc.js
diff --git a/docs/.gitignore b/docs/.gitignore
@@ -1,3 +1,20 @@
-.docz
-.cache
-public
+# Dependencies
+/node_modules
+
+# Production
+/build
+
+# Generated files
+.docusaurus
+.cache-loader
+
+# Misc
+.DS_Store
+.env.local
+.env.development.local
+.env.test.local
+.env.production.local
+
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
diff --git a/docs/.htaccess b/docs/.htaccess
diff --git a/docs/.nvmrc b/docs/.nvmrc
diff --git a/docs/README.md b/docs/README.md
@@ -1,69 +1,33 @@
-<!--
-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
+# Website
 
-  http://www.apache.org/licenses/LICENSE-2.0
+This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
 
-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.
--->
+### Installation
 
-Here's the source to the documentation hosted at
-<a href="https://superset.apache.org">superset.apache.org</a>
-
-The site runs on the Gatsby framework and uses docz for it's
-`Documentation` subsection.
-
-## Getting Started
-
-```bash
-cd docs/
-npm install
-npm run start
-# navigate to localhost:8000`
+```
+$ yarn
 ```
 
-## To Publish
-
-Github Actions CI automatically publishes the site after changes are
-merged to master.
+### Local Development
 
-To manually publish, the static site that Gatsby generates needs to be pushed
-to the `asf-site` branch on the
-[apache/superset-site](https://github.com/apache/superset-site/)
-repository. No need to PR here, simply `git push`.
+```
+$ yarn start
+```
 
-```bash
-# Get in the docs/ folder in the main repo
-cd ~/repos/superset/docs
-# have Gatsby build the static website, this puts in under `docs/public`
-npm run build
+This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
 
-# go to the docs repo
-cd ~/repos/superset-site
-# checkout the proper branch
-git checkout asf-site
+### Build
 
-# BE CAREFUL WITH THIS COMMAND
-# wipe the content of the repo
-rm -rf *
+```
+$ yarn build
+```
 
-# copy the static site here
-cp -r ~/repos/superset/docs/public/ ./
+This command generates static content into the `build` directory and can be served using any static contents hosting service.
 
-# git push
-git add .
-git commit -m "relevant commit msg"
-git push origin asf-site
+### Deployment
 
-# SUCCESS - it should take minutes to take effect on superset.apache.org
 ```
+$ GIT_USER=<Your GitHub username> USE_SSH=true yarn deploy
+```
+
+If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
diff --git a/docs-v2/babel.config.js → docs/babel.config.js b/docs-v2/babel.config.js → docs/babel.config.js
diff --git a/docs-v2/docs/Contributing/_category_.json → docs/docs/Contributing/_category_.json b/docs-v2/docs/Contributing/_category_.json → docs/docs/Contributing/_category_.json
diff --git a/...2/docs/Contributing/contributing-page.mdx → docs/docs/Contributing/contributing-page.mdx b/...2/docs/Contributing/contributing-page.mdx → docs/docs/Contributing/contributing-page.mdx
diff --git a/...s/Contributing/conventions-and-typing.mdx → ...s/Contributing/conventions-and-typing.mdx b/...s/Contributing/conventions-and-typing.mdx → ...s/Contributing/conventions-and-typing.mdx
diff --git a/...2/docs/Contributing/hooks-and-linting.mdx → docs/docs/Contributing/hooks-and-linting.mdx b/...2/docs/Contributing/hooks-and-linting.mdx → docs/docs/Contributing/hooks-and-linting.mdx
diff --git a/docs-v2/docs/Contributing/local-backend.mdx → docs/docs/Contributing/local-backend.mdx b/docs-v2/docs/Contributing/local-backend.mdx → docs/docs/Contributing/local-backend.mdx
diff --git a/.../Contributing/pull-request-guidelines.mdx → .../Contributing/pull-request-guidelines.mdx b/.../Contributing/pull-request-guidelines.mdx → .../Contributing/pull-request-guidelines.mdx
diff --git a/docs-v2/docs/Contributing/style-guide.mdx → docs/docs/Contributing/style-guide.mdx b/docs-v2/docs/Contributing/style-guide.mdx → docs/docs/Contributing/style-guide.mdx
diff --git a/...-v2/docs/Contributing/testing-locally.mdx → docs/docs/Contributing/testing-locally.mdx b/...-v2/docs/Contributing/testing-locally.mdx → docs/docs/Contributing/testing-locally.mdx
diff --git a/docs-v2/docs/Contributing/translations.mdx → docs/docs/Contributing/translations.mdx b/docs-v2/docs/Contributing/translations.mdx → docs/docs/Contributing/translations.mdx
diff --git a/...s/Contributing/types-of-contributions.mdx → ...s/Contributing/types-of-contributions.mdx b/...s/Contributing/types-of-contributions.mdx → ...s/Contributing/types-of-contributions.mdx
diff --git a/...ing Charts and Dashboards/_category_.json → ...ing Charts and Dashboards/_category_.json b/...ing Charts and Dashboards/_category_.json → ...ing Charts and Dashboards/_category_.json
diff --git a/...hboards/creating-your-first-dashboard.mdx → ...hboards/creating-your-first-dashboard.mdx b/...hboards/creating-your-first-dashboard.mdx → ...hboards/creating-your-first-dashboard.mdx
diff --git a/... Charts and Dashboards/exploring-data.mdx → ... Charts and Dashboards/exploring-data.mdx b/... Charts and Dashboards/exploring-data.mdx → ... Charts and Dashboards/exploring-data.mdx
diff --git a/docs-v2/docs/api.mdx → docs/docs/api.mdx b/docs-v2/docs/api.mdx → docs/docs/api.mdx
diff --git a/...s/connecting-to-databases/_category_.json → ...s/connecting-to-databases/_category_.json b/...s/connecting-to-databases/_category_.json → ...s/connecting-to-databases/_category_.json
diff --git a/...2/docs/connecting-to-databases/ascend.mdx → docs/docs/connecting-to-databases/ascend.mdx b/...2/docs/connecting-to-databases/ascend.mdx → docs/docs/connecting-to-databases/ascend.mdx
diff --git a/...2/docs/connecting-to-databases/athena.mdx → docs/docs/connecting-to-databases/athena.mdx b/...2/docs/connecting-to-databases/athena.mdx → docs/docs/connecting-to-databases/athena.mdx
diff --git a/...docs/connecting-to-databases/bigquery.mdx → ...docs/connecting-to-databases/bigquery.mdx b/...docs/connecting-to-databases/bigquery.mdx → ...docs/connecting-to-databases/bigquery.mdx
diff --git a/...cs/connecting-to-databases/clickhouse.mdx → ...cs/connecting-to-databases/clickhouse.mdx b/...cs/connecting-to-databases/clickhouse.mdx → ...cs/connecting-to-databases/clickhouse.mdx
diff --git a/...s/connecting-to-databases/cockroachdb.mdx → ...s/connecting-to-databases/cockroachdb.mdx b/...s/connecting-to-databases/cockroachdb.mdx → ...s/connecting-to-databases/cockroachdb.mdx
diff --git a/.../docs/connecting-to-databases/cratedb.mdx → .../docs/connecting-to-databases/cratedb.mdx b/.../docs/connecting-to-databases/cratedb.mdx → .../docs/connecting-to-databases/cratedb.mdx
diff --git a/...cs/connecting-to-databases/databricks.mdx → ...cs/connecting-to-databases/databricks.mdx b/...cs/connecting-to-databases/databricks.mdx → ...cs/connecting-to-databases/databricks.mdx
diff --git a/...necting-to-databases/db-connection-ui.mdx → ...necting-to-databases/db-connection-ui.mdx b/...necting-to-databases/db-connection-ui.mdx → ...necting-to-databases/db-connection-ui.mdx
diff --git a/...cting-to-databases/docker-add-drivers.mdx → ...cting-to-databases/docker-add-drivers.mdx b/...cting-to-databases/docker-add-drivers.mdx → ...cting-to-databases/docker-add-drivers.mdx
diff --git a/...2/docs/connecting-to-databases/dremio.mdx → docs/docs/connecting-to-databases/dremio.mdx b/...2/docs/connecting-to-databases/dremio.mdx → docs/docs/connecting-to-databases/dremio.mdx
diff --git a/...v2/docs/connecting-to-databases/drill.mdx → docs/docs/connecting-to-databases/drill.mdx b/...v2/docs/connecting-to-databases/drill.mdx → docs/docs/connecting-to-databases/drill.mdx
diff --git a/...v2/docs/connecting-to-databases/druid.mdx → docs/docs/connecting-to-databases/druid.mdx b/...v2/docs/connecting-to-databases/druid.mdx → docs/docs/connecting-to-databases/druid.mdx
diff --git a/...connecting-to-databases/elasticsearch.mdx → ...connecting-to-databases/elasticsearch.mdx b/...connecting-to-databases/elasticsearch.mdx → ...connecting-to-databases/elasticsearch.mdx
diff --git a/...2/docs/connecting-to-databases/exasol.mdx → docs/docs/connecting-to-databases/exasol.mdx b/...2/docs/connecting-to-databases/exasol.mdx → docs/docs/connecting-to-databases/exasol.mdx
diff --git a/...onnecting-to-databases/extra-settings.mdx → ...onnecting-to-databases/extra-settings.mdx b/...onnecting-to-databases/extra-settings.mdx → ...onnecting-to-databases/extra-settings.mdx
diff --git a/...docs/connecting-to-databases/firebird.mdx → ...docs/connecting-to-databases/firebird.mdx b/...docs/connecting-to-databases/firebird.mdx → ...docs/connecting-to-databases/firebird.mdx
diff --git a/...docs/connecting-to-databases/firebolt.mdx → ...docs/connecting-to-databases/firebolt.mdx b/...docs/connecting-to-databases/firebolt.mdx → ...docs/connecting-to-databases/firebolt.mdx
diff --git a/...connecting-to-databases/google-sheets.mdx → ...connecting-to-databases/google-sheets.mdx b/...connecting-to-databases/google-sheets.mdx → ...connecting-to-databases/google-sheets.mdx
diff --git a/...-v2/docs/connecting-to-databases/hana.mdx → docs/docs/connecting-to-databases/hana.mdx b/...-v2/docs/connecting-to-databases/hana.mdx → docs/docs/connecting-to-databases/hana.mdx
diff --git a/...-v2/docs/connecting-to-databases/hive.mdx → docs/docs/connecting-to-databases/hive.mdx b/...-v2/docs/connecting-to-databases/hive.mdx → docs/docs/connecting-to-databases/hive.mdx
diff --git a/...docs/connecting-to-databases/hologres.mdx → ...docs/connecting-to-databases/hologres.mdx b/...docs/connecting-to-databases/hologres.mdx → ...docs/connecting-to-databases/hologres.mdx
diff --git a/.../docs/connecting-to-databases/ibm-db2.mdx → .../docs/connecting-to-databases/ibm-db2.mdx b/.../docs/connecting-to-databases/ibm-db2.mdx → .../docs/connecting-to-databases/ibm-db2.mdx
diff --git a/...2/docs/connecting-to-databases/impala.mdx → docs/docs/connecting-to-databases/impala.mdx b/...2/docs/connecting-to-databases/impala.mdx → docs/docs/connecting-to-databases/impala.mdx
diff --git a/...databases/installing-database-drivers.mdx → ...databases/installing-database-drivers.mdx b/...databases/installing-database-drivers.mdx → ...databases/installing-database-drivers.mdx
diff --git a/...v2/docs/connecting-to-databases/kylin.mdx → docs/docs/connecting-to-databases/kylin.mdx b/...v2/docs/connecting-to-databases/kylin.mdx → docs/docs/connecting-to-databases/kylin.mdx
diff --git a/...v2/docs/connecting-to-databases/mysql.mdx → docs/docs/connecting-to-databases/mysql.mdx b/...v2/docs/connecting-to-databases/mysql.mdx → docs/docs/connecting-to-databases/mysql.mdx
diff --git a/.../docs/connecting-to-databases/netezza.mdx → .../docs/connecting-to-databases/netezza.mdx b/.../docs/connecting-to-databases/netezza.mdx → .../docs/connecting-to-databases/netezza.mdx
diff --git a/...2/docs/connecting-to-databases/oracle.mdx → docs/docs/connecting-to-databases/oracle.mdx b/...2/docs/connecting-to-databases/oracle.mdx → docs/docs/connecting-to-databases/oracle.mdx
diff --git a/...v2/docs/connecting-to-databases/pinot.mdx → docs/docs/connecting-to-databases/pinot.mdx b/...v2/docs/connecting-to-databases/pinot.mdx → docs/docs/connecting-to-databases/pinot.mdx
diff --git a/...docs/connecting-to-databases/postgres.mdx → ...docs/connecting-to-databases/postgres.mdx b/...docs/connecting-to-databases/postgres.mdx → ...docs/connecting-to-databases/postgres.mdx
diff --git a/...2/docs/connecting-to-databases/presto.mdx → docs/docs/connecting-to-databases/presto.mdx b/...2/docs/connecting-to-databases/presto.mdx → docs/docs/connecting-to-databases/presto.mdx
diff --git a/...docs/connecting-to-databases/redshift.mdx → ...docs/connecting-to-databases/redshift.mdx b/...docs/connecting-to-databases/redshift.mdx → ...docs/connecting-to-databases/redshift.mdx
diff --git a/.../docs/connecting-to-databases/rockset.mdx → .../docs/connecting-to-databases/rockset.mdx b/.../docs/connecting-to-databases/rockset.mdx → .../docs/connecting-to-databases/rockset.mdx
diff --git a/...ocs/connecting-to-databases/snowflake.mdx → ...ocs/connecting-to-databases/snowflake.mdx b/...ocs/connecting-to-databases/snowflake.mdx → ...ocs/connecting-to-databases/snowflake.mdx
diff --git a/...-v2/docs/connecting-to-databases/solr.mdx → docs/docs/connecting-to-databases/solr.mdx b/...-v2/docs/connecting-to-databases/solr.mdx → docs/docs/connecting-to-databases/solr.mdx
diff --git a/...ocs/connecting-to-databases/spark-sql.mdx → ...ocs/connecting-to-databases/spark-sql.mdx b/...ocs/connecting-to-databases/spark-sql.mdx → ...ocs/connecting-to-databases/spark-sql.mdx
diff --git a/...cs/connecting-to-databases/sql-server.mdx → ...cs/connecting-to-databases/sql-server.mdx b/...cs/connecting-to-databases/sql-server.mdx → ...cs/connecting-to-databases/sql-server.mdx
diff --git a/...docs/connecting-to-databases/teradata.mdx → ...docs/connecting-to-databases/teradata.mdx b/...docs/connecting-to-databases/teradata.mdx → ...docs/connecting-to-databases/teradata.mdx
diff --git a/...v2/docs/connecting-to-databases/trino.mdx → docs/docs/connecting-to-databases/trino.mdx b/...v2/docs/connecting-to-databases/trino.mdx → docs/docs/connecting-to-databases/trino.mdx
diff --git a/.../docs/connecting-to-databases/vertica.mdx → .../docs/connecting-to-databases/vertica.mdx b/.../docs/connecting-to-databases/vertica.mdx → .../docs/connecting-to-databases/vertica.mdx
diff --git a/docs-v2/docs/frequently-asked-questions.mdx → docs/docs/frequently-asked-questions.mdx b/docs-v2/docs/frequently-asked-questions.mdx → docs/docs/frequently-asked-questions.mdx
diff --git a/docs-v2/docs/installation/_category_.json → docs/docs/installation/_category_.json b/docs-v2/docs/installation/_category_.json → docs/docs/installation/_category_.json
diff --git a/docs-v2/docs/installation/alerts-reports.mdx → docs/docs/installation/alerts-reports.mdx b/docs-v2/docs/installation/alerts-reports.mdx → docs/docs/installation/alerts-reports.mdx
diff --git a/...ocs/installation/async-queries-celery.mdx → ...ocs/installation/async-queries-celery.mdx b/...ocs/installation/async-queries-celery.mdx → ...ocs/installation/async-queries-celery.mdx
diff --git a/...tallation/building-custom-viz-plugins.mdx → ...tallation/building-custom-viz-plugins.mdx b/...tallation/building-custom-viz-plugins.mdx → ...tallation/building-custom-viz-plugins.mdx
diff --git a/docs-v2/docs/installation/cache.mdx → docs/docs/installation/cache.mdx b/docs-v2/docs/installation/cache.mdx → docs/docs/installation/cache.mdx
diff --git a/...ocs/installation/configuring-superset.mdx → ...ocs/installation/configuring-superset.mdx b/...ocs/installation/configuring-superset.mdx → ...ocs/installation/configuring-superset.mdx
diff --git a/docs-v2/docs/installation/event-logging.mdx → docs/docs/installation/event-logging.mdx b/docs-v2/docs/installation/event-logging.mdx → docs/docs/installation/event-logging.mdx
diff --git a/...tion/installing-superset-from-scratch.mdx → ...tion/installing-superset-from-scratch.mdx b/...tion/installing-superset-from-scratch.mdx → ...tion/installing-superset-from-scratch.mdx
diff --git a/...talling-superset-using-docker-compose.mdx → ...talling-superset-using-docker-compose.mdx b/...talling-superset-using-docker-compose.mdx → ...talling-superset-using-docker-compose.mdx
diff --git a/...docs/installation/networking-settings.mdx → ...docs/installation/networking-settings.mdx b/...docs/installation/networking-settings.mdx → ...docs/installation/networking-settings.mdx
diff --git a/...cs/installation/running-on-kubernetes.mdx → ...cs/installation/running-on-kubernetes.mdx b/...cs/installation/running-on-kubernetes.mdx → ...cs/installation/running-on-kubernetes.mdx
diff --git a/docs-v2/docs/installation/sql-templating.mdx → docs/docs/installation/sql-templating.mdx b/docs-v2/docs/installation/sql-templating.mdx → docs/docs/installation/sql-templating.mdx
diff --git a/.../docs/installation/upgrading-superset.mdx → .../docs/installation/upgrading-superset.mdx b/.../docs/installation/upgrading-superset.mdx → .../docs/installation/upgrading-superset.mdx
diff --git a/docs-v2/docs/intro.mdx → docs/docs/intro.mdx b/docs-v2/docs/intro.mdx → docs/docs/intro.mdx
diff --git a/docs-v2/docs/miscellaneous/_category_.json → docs/docs/miscellaneous/_category_.json b/docs-v2/docs/miscellaneous/_category_.json → docs/docs/miscellaneous/_category_.json
diff --git a/docs-v2/docs/miscellaneous/chart-params.mdx → docs/docs/miscellaneous/chart-params.mdx b/docs-v2/docs/miscellaneous/chart-params.mdx → docs/docs/miscellaneous/chart-params.mdx
diff --git a/.../docs/miscellaneous/country-map-tools.mdx → .../docs/miscellaneous/country-map-tools.mdx b/.../docs/miscellaneous/country-map-tools.mdx → .../docs/miscellaneous/country-map-tools.mdx
diff --git a/...neous/importing-exporting-datasources.mdx → ...neous/importing-exporting-datasources.mdx b/...neous/importing-exporting-datasources.mdx → ...neous/importing-exporting-datasources.mdx
diff --git a/docs-v2/docs/miscellaneous/issue-codes.mdx → docs/docs/miscellaneous/issue-codes.mdx b/docs-v2/docs/miscellaneous/issue-codes.mdx → docs/docs/miscellaneous/issue-codes.mdx
diff --git a/docs-v2/docs/roadmap.mdx → docs/docs/roadmap.mdx b/docs-v2/docs/roadmap.mdx → docs/docs/roadmap.mdx
diff --git a/docs-v2/docs/security.mdx → docs/docs/security.mdx b/docs-v2/docs/security.mdx → docs/docs/security.mdx
diff --git a/docs-v2/docusaurus.config.js → docs/docusaurus.config.js b/docs-v2/docusaurus.config.js → docs/docusaurus.config.js