docs: add script to generate some docs from nix attrs

2025-01-20 11:06:01 -05:00 · 2025-01-20 11:06:01 -05:00 · a4c953df3b
commit a4c953df3b
parent 5621df5749
7 changed files with 45 additions and 5 deletions
--- a/apps/gen-docs/script.sh
+++ b/apps/gen-docs/script.sh
@ -0,0 +1,12 @@
+substitute() {
+    echo '' | pandoc --metadata-file <(
+        nix eval \
+            --impure \
+            --json \
+            .#"$1" \
+            --apply "(x: {attrs = builtins.mapAttrs (_: v: v.meta.description or \"\") x.\${builtins.currentSystem};})" |
+            jq -r
+    ) -t markdown --template "$2" -o "$3"
+}
+
+substitute "devShells" "./templates/devShells.md" "$FLAKE/devShells/README.md"