1
1
mirror of https://github.com/NixOS/mobile-nixos.git synced 2024-12-13 12:35:48 +03:00
mobile-nixos/doc
2019-11-15 22:02:10 -05:00
..
_support doc: Getting started 2019-11-15 22:02:10 -05:00
misc doc: Adds documentation and documentation support 2019-11-15 22:02:06 -05:00
.gitignore doc: Adds documentation and documentation support 2019-11-15 22:02:06 -05:00
default.nix doc: copy image resources 2019-11-15 22:02:10 -05:00
getting-started.adoc doc: Getting started 2019-11-15 22:02:10 -05:00
pkgs.nix doc: Adds documentation and documentation support 2019-11-15 22:02:06 -05:00
porting-guide.adoc doc: Adds a stub of a porting guide. 2019-11-15 22:02:10 -05:00
README.md doc: Adds documentation and documentation support 2019-11-15 22:02:06 -05:00

Documentation internal notes

This document is not to be generated into the website/documentation.


Implementation notes

This documentation folder generates the Mobile NixOS website and documentation as a whole.

The documentation is to be written in asciidoc, and converted through a custom pipeline through the Asciidoctor API. Markdown files are accepted in the pipeline, but frowned upon except for the simplest documentation articles.

The build pipeline can be improved upon, and contributions doing so are welcome!

Devices list

The devices folder is special and assumes it will be replaced in-place with asciidoc source files generated from a build outside of the main documentation build. This is because it is generated from the actual device descriptions from the repository.

Sitemap

The sitemap is simply a dump of all document files and "catalogs" from as parsed by Asciidoctor.