superset/docs
leocape 1697e1e3b1
chore: update docs for new alerts and reporting feature (#13104)
* update docs for new alerts and reporting feature

* fix punctuation

* fix punctuation

* fix punctuation

fix bullets
fix redis depends on name in docker-compose template

* fix bullets

* Add extra steps for getting v1.0.1 running

step added: Upgrade the db
step added: init
step added: setup admin
fix redis superset naming
add . to docker build command

* fix worker to use gevent instead of prefork

change postgres to internal so it persists on docker-compose down

* add comments to superset_config.py

* ref: Re-organize a bit and make it easier to read

* ref: rm useless level

* docs: md changes + more details + kubernetes

* docs: Rename to Alerts and Reports

* docs: Link to Kubernetes doc

* docs: details for docker-compose + minor md changes

* docs: fix lists indent

* docs: remove unused config

* docs: Put detailed config and dockerfile before specific stuff

* docs: clean Dockerfiles

Co-authored-by: Valentin NOURDIN <vnourdin.externe@bedrockstreaming.com>
2021-02-26 10:19:08 -05:00
..
src chore: update docs for new alerts and reporting feature (#13104) 2021-02-26 10:19:08 -05:00
static/images docs: Updates to Superset Site for 1.0 (#12626) 2021-01-26 11:13:39 -05: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: fix redirect from bad find/replace (#12642) 2021-01-20 20:25:01 -08:00
.prettierrc docs(new docs site): removes old sphinx doc site with gatsby (#10784) 2020-09-11 22:59:12 -07:00
README.md chore: remove harmless incubator refs (#12289) 2021-01-06 13:45:19 +02: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: Remove gatsby-plugin-offline (#12693) 2021-01-25 12:57:22 -05: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 Add docs for GLOBAL_ASYNC_QUERIES (SIP-39) (#12573) 2021-01-19 13:57:25 -08:00
package-lock.json docs: Remove gatsby-plugin-offline (#12693) 2021-01-25 12:57:22 -05:00
package.json docs: Remove gatsby-plugin-offline (#12693) 2021-01-25 12:57:22 -05: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 chore: remove harmless incubator refs (#12289) 2021-01-06 13:45:19 +02: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/superset-site repository. No need to PR here, simply git push.

# 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

# go to the docs repo
cd ~/repos/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/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