zero-to-flakes

Local

In nix shell,

, run

Guidelines for writing docs

Slugs

Slugs must in the form of either of the following:

• /foo: A single component slug for all docs by default
• /<module>/foo: Documentation for page "foo" under flake-parts module named "".

Linking

Unfortunately, Docusaurus is not great with cross-linking, so you must always link to pages using slugs (see section above) rather than file paths. If a link is broken, then the Docusaurus build will fail.

Preview & CI

When editing the docs of your flake-parts modules, if there is a git submodule reference to them, you can do those edits in that submodule checkout. The local server will pickup those changes.