From 0c4e4df772dc0b20b314417b87a43dd85292fa99 Mon Sep 17 00:00:00 2001
From: alexion <contact@alexion.dev>
Date: Fri, 28 Aug 2026 10:08:10 -0400
Subject: [PATCH] docs(nix): clarify module file interfaces

---
 docs/nix.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/nix.md b/docs/nix.md
index c53ee92..78a7b90 100644
--- a/docs/nix.md
+++ b/docs/nix.md
@@ -101,7 +101,8 @@ import ./flake {
 
 ### Keep NixOS module interfaces open
 
-NixOS modules accept extra arguments because the module system owns their argument shape.
+Files under `hosts/`, `guests/`, and `modules/` return NixOS modules.
+The NixOS module system owns their argument shape.
 Name each argument the module uses.
 Keep `...` so the module accepts standard module arguments and special arguments.