about summary refs log tree commit diff
path: root/modules/README.md
blob: 5d62d3acca7f39cede0693c0c1e4dc470c34ab4d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
This directory contains various NixOS modules.

If you add a module here, make sure that you define all options using a
`vuizvui.*` namespace, so that the documentation is generated and you don't
clash with modules from upstream [nixpkgs](https://github.com/NixOS/nixpkgs).

For writing modules, make sure to categorize them accordingly:

<table>
  <tr>
    <th>profiles</th>
    <td>Options for a specific domain (like for example
        `desktop`, `router`, `music`, ...)
    </td>
  </tr>
  <tr>
    <th>programs</th>
    <td>Program-specific configuration options</td>
  </tr>
  <tr>
    <th>services</th>
    <td>Modules that implement systemd services</td>
  </tr>
  <tr>
    <th>tasks</th>
    <td>Various one-shot services</td>
  </tr>
</table>

If a module is highly specific for your own configuration, use the same
categories but put them under `user/$category/$module`.

Don't forget to add your module to the list module-list.nix, but make sure you
have options in place to disable them by default.