9glenda / zero-to-flakes

WIP: Nothing here, move along

Home Page:https://zero-to-flakes.com

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

zero-to-flakes

Local

In nix shell,

just 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.

Submodules

Individual module's docs are stored as git submodules. Run just update to update them all.

About

WIP: Nothing here, move along

https://zero-to-flakes.com


Languages

Language:MDX 60.0%Language:JavaScript 23.2%Language:TypeScript 8.3%Language:CSS 4.7%Language:Nix 3.1%Language:Just 0.7%