diff --git a/nixos/modules/README.rst b/nixos/modules/README.rst
index bf411a0839f6ab9a1d61376526c31cffaa469351..b395eace08655ade8b52262dbdf3bf62664d1c66 100644
--- a/nixos/modules/README.rst
+++ b/nixos/modules/README.rst
@@ -1,2 +1,5 @@
-These are mostly modelled on upstream nixos modules, are generally fairly configurable (they don't tend to hard-code paths, they can be enabled or disabled), and they don't know anything about morph (e.g. deployment.secrets) or how the different grids are configured (i.e. grid.publicKeyPath). Each module here tends to define one service (or group of related services) or feature.
-Eventually, all of these will be imported automatically, and controlled by services.private-storage.*.enabled options.
+These are mostly modelled on upstream nixos modules.
+They are generally fairly configurable (they don't tend to hard-code paths, they can be enabled or disabled).
+They don't know anything about morph (e.g. ``deployment.secrets``) or how the different grids are configured (e.g. ``grid.publicKeyPath``).
+Each module here tends to define one service (or group of related services) or feature.
+Eventually, all of these will be imported automatically and controlled by ``services.private-storage.*.enabled`` options.