Files
superset2/docs
Srini Kadamati 53e2fa6f57 chore: updated screenshots in README.md and added recent events (#17650)
* chore: updated screenshots in readme.md and added recent events

* chore: updated pinot superset connection instructions

* fixed outdated slack link

* addressed all outstanding feedback!

* updated package lock

* reverted package.json to master

* Update README.md

Co-authored-by: Evan Rusackas <evan@preset.io>

Co-authored-by: Evan Rusackas <evan@preset.io>
2021-12-17 11:43:46 -05:00
..
2021-07-28 15:32:03 -04:00
2021-04-23 10:43:58 -06:00

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

Github Actions CI automatically publishes the site after changes are merged to master.

To manually 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