This is the source for the docs.fission.io website. It contains docs for both the Fission and Fission Workflows projects.

This is a hugo statically-generated site, hosted on netlify. The site is automatically built by netlify (see netlify.toml and build.sh).

• docs/ is the source. It's a hugo site.
  • docs/content this is where the documentation content lives.
  • docs/config.toml is some hugo configuration, such as the base URL of the website, the theme etc.
• dist/ is the directory that's actually served at https://docs.fission.io
  • dist/archive has older versions of the docs are archived here. These are kept for reference purpose and will be eventually removed. All older versions are redirected to current version of docs
  • dist/public is the root of latest/live documentation
• build.sh is run by netlify. It runs hugo and places the generated site under dist/public

cd docs/
hugo new usage/how-to-use-ShinyNewThing.md

Find the doc under docs/content, edit it, make a pull request. You can use Github's handy UI for editing docs.

cd docs/
hugo serve -D
# This will output a link that you can open in a browser.

Make a pull request with your changes to the source. There should be no changes under the dist directory. When the pull request is merged the site will automatically be updated by netlify.