Skip to content

brsvh/zero-to-flakes

 
 

Repository files navigation

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

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 42.1%
  • TypeScript 24.0%
  • CSS 13.7%
  • MDX 9.2%
  • Nix 9.0%
  • Just 2.0%