superset/docs
Elizabeth Thompson 895fa19d8d
chore: add latest tag action (#11148)
* add latest tag action

* update documentation with latest tag info

* Python in docs doesn't need v3 reference

* add check that latest tag is truly a later version

* remove rc from acceptable tags

* move tag script to seperate file

* add a check that the tag exists
2020-12-17 20:50:44 +02:00
..
src chore: add latest tag action (#11148) 2020-12-17 20:50:44 +02:00
static/images docs: add a roadmap page pointing to SIP-53 (#11169) 2020-10-20 21:36:06 -07:00
.eslintrc.js docs(style): make more responsive for mobile (#10853) 2020-09-14 11:58:45 -07:00
.gitignore docs(new docs site): removes old sphinx doc site with gatsby (#10784) 2020-09-11 22:59:12 -07:00
.htaccess docs: comply to ASF requirements (#11133) 2020-10-01 22:15:36 -07:00
.prettierrc docs(new docs site): removes old sphinx doc site with gatsby (#10784) 2020-09-11 22:59:12 -07:00
README.md docs: restored page on roles in security, executed other touchups, and… (#11978) 2020-12-13 14:06:14 -08:00
doczrc.js docs: add API page to docs using Swagger UI (#11154) 2020-10-04 22:01:36 -07:00
gatsby-config.js docs: add support for Google Analytics on superset.apache.org (#11613) 2020-11-12 13:57:05 -08:00
gatsby-node.js docs: restored page on roles in security, executed other touchups, and… (#11978) 2020-12-13 14:06:14 -08:00
installation.rst update docs around email reports (#11783) 2020-11-24 11:43:43 -08:00
package-lock.json docs: add support for Google Analytics on superset.apache.org (#11613) 2020-11-12 13:57:05 -08:00
package.json docs: add support for Google Analytics on superset.apache.org (#11613) 2020-11-12 13:57:05 -08:00
prettier.config.js docs(new docs site): removes old sphinx doc site with gatsby (#10784) 2020-09-11 22:59:12 -07:00
requirements.txt docs(new docs site): removes old sphinx doc site with gatsby (#10784) 2020-09-11 22:59:12 -07:00
sqllab.rst security: disallow uuid package on jinja2 (#10794) 2020-09-04 16:37:14 +01:00

README.md

Here's the source to the documentation hosted at superset.apache.org

The site runs on the Gatsby framework and uses docz for it's Documentation subsection.

Getting Started

cd docs/
npm install
npm run start
# navigate to localhost:8000`

To Publish

To publish, the static site that Gatsby generates needs to be pushed to the asf-site branch on the apache/incubator-superset-site repository. No need to PR here, simply git push.

# Get in the docs/ folder in the main repo
cd ~/repos/incubator-superset/docs
# have Gatsby build the static website, this puts in under `docs/public`
npm run build

# go to the docs repo
cd ~/repos/incubator-superset-site
# checkout the proper branch
git checkout asf-site

# BE CAREFUL WITH THIS COMMAND
# wipe the content of the repo
rm -rf *

# copy the static site here
cp -r ~/repos/incubator-superset/docs/public/ ./

# git push
git add .
git commit -m "relevant commit msg"
git push origin asf-site

# SUCCESS - it should take minutes to take effect on superset.apache.org