my over complex system configurations
dotfiles.isabelroses.com/
nixos
nix
flake
dotfiles
linux
docs: mention specific lib
+15
-2
+15
-2
docs/src/content/docs/design/modules.md
+15
-2
docs/src/content/docs/design/modules.md
···
3
3
description: Conventions for writing modules in this flake.
4
4
---
5
5
6
+
## Introduction
7
+
6
8
When writing a module, you should follow these guidelines:
7
9
8
-
- Use a tree-like structure for the head lambda args if and only if it is needed.
10
+
### Module Headers
11
+
12
+
13
+
Use a tree-like structure for the head lambda args if and only if it is needed.
9
14
10
15
```nix
11
16
{
···
19
24
}
20
25
```
21
26
22
-
- `imports` should do its best to avoid going backwards in the flake's file structure.
27
+
### File Structure
28
+
29
+
Every use of `imports` should make a good attempt not to use `../` (going up in
30
+
the file structure). I would like to have a simple file structure and this
31
+
helps achieve that.
23
32
33
+
### Lib Usage
34
+
35
+
When using lib you should ideally be as specific as possible. This may look
36
+
like moving from `lib.mkOption` to `lib.options.mkOption`.