nixos/doc/manual: Add `/var/lib/nixos` under “Necessary system state”

1 files changed, 10 insertions, 5 deletions

diff --git a/nixos/doc/manual/administration/nixos-state.section.md b/nixos/doc/manual/administration/nixos-state.section.md
index 403195faa59d..2443918c9d7c 100644
--- a/nixos/doc/manual/administration/nixos-state.section.md
+++ b/nixos/doc/manual/administration/nixos-state.section.md
@@ -6,8 +6,13 @@ can be linked from the nix store during activation.
 Moreover, `/boot` should also be persistent, as it contains the kernel, initrd,
 and the command-line determining the system environment's path in the nix store.
 
-Lastly, `users.mutableUsers` should be false, *or* the following files under
-`/etc` should all persist:
-- {manpage}`passwd(5)` and {manpage}`group(5)`,
-- {manpage}`shadow(5)` and {manpage}`gshadow(5)`,
-- {manpage}`subuid(5)` and {manpage}`subgid(5)`.
+
+## Users and groups {#sec-state-users}
+
+- `/var/lib/nixos` should persist: it holds state needed to generate stable
+  uids and gids for declaratively-managed users and groups, etc.
+- `users.mutableUsers` should be false, *or* the following files under `/etc`
+  should all persist:
+  - {manpage}`passwd(5)` and {manpage}`group(5)`,
+  - {manpage}`shadow(5)` and {manpage}`gshadow(5)`,
+  - {manpage}`subuid(5)` and {manpage}`subgid(5)`.