Add role documentation

This commit is contained in:
Fabian Hauser 2020-04-21 22:12:37 +02:00
parent 0f509a7c8e
commit 5f5d6293eb
7 changed files with 74 additions and 0 deletions

21
README.adoc Normal file
View file

@ -0,0 +1,21 @@
[[qois-infrastructure]]
qo.is Infrastructure
--------------------
This repository contains the infrastructure configuration.
Structure
~~~~~~~~~
`hardware`:: Hardware specific configuration files, e.g. for wireless
cards.
`host`:: Main nixos `configuration.nix` for every host. The
`configuration.nix` is symlinked to the specific host file.
`role`:: Host roles, which are included from a host's configuration.
`docs`:: Documentation of the concrete qo.is infrastructure
Development
~~~~~~~~~~~
* The nix files shoud be formatted using nixfmt:
** `nixfmt -c $(git ls-files *.nix)`