Docs are based on:
docsify, a dynamic , markdown based generator.mdoc, typechecked scala/markdown compiler
The source for the docs is in yourProject/docs, the website in
yourProject/target/website. The currently deployed website is in the
gh-pages branch.
To preview the site locally, you need to install:
npm i docsify-cli -g
then, start mdoc in an sbt session:
sbt docs/mdoc --watch
and docsify in a shell session:
cd yourProject/target/website
docsify serve .
and you'll get an updating preview.
Note that mdoc watches the markdown files, so if you change the code
itself it will need a manual recompile.
docsify uses 3 special files: index.html, _coverpage.md, _sidebar.md,
the sidebar needs to have a specific format:
- newlines in between headers
- and no extra modifiers inside links
[good],[**bad**](or collapse will not work)
Push a vx.y.z tag on main to release. It will fail if semver isn't
respected wrt bincompat.
Docs are released automatically on each push to main.