goreleaser/www

Documentation

Documentation is written in mkdocs and there are a few extensions that allow richer authoring than markdown.

To iterate with documentation, therefore, it is recommended to run the mkdocs server and view your pages in a browser.

Prerequisites

• Get Task
• Get MkDocs
  • Get MkDocs Material
  • Get MkDocs Redirect
  • Get MkDocs Minify
  • Get MkDocs Include Markdown
  • Get MkDocs RSS

With nix

If you have nix installed, you can:

nix develop .#docs

To drop into a shell with all the needed dependencies.

Edit the docs

After installing mkdocs and extensions, build and run the documentation locally:

task docs:serve

The site will soon be available at http://localhost:8000 and auto-update after changes.