diff --git a/justfile b/justfile
index 7870440..3715e45 100644
--- a/justfile
+++ b/justfile
@@ -1,3 +1,4 @@
+# Compile all documentation as in proposals and design documents, placing them under `docs/compiled`.
 docs:
   #!/usr/bin/env nu
   glob **/*.typ --exclude [**/{template.typ,util/**}] | par-each { |source|