From a35780e489728bd9d064b8cb24341b82722194c7 Mon Sep 17 00:00:00 2001
From: clerie <git@clerie.de>
Date: Sat, 14 Oct 2023 21:09:26 +0200
Subject: [PATCH] Document integration of nerd

---
 docs/extension/nerd.md | 33 +++++++++++++++++++++++++++++++++
 mkdocs.yml             |  2 ++
 2 files changed, 35 insertions(+)
 create mode 100644 docs/extension/nerd.md

diff --git a/docs/extension/nerd.md b/docs/extension/nerd.md
new file mode 100644
index 0000000..de68e0c
--- /dev/null
+++ b/docs/extension/nerd.md
@@ -0,0 +1,33 @@
+# Nerd web interface
+
+Nerd is a web interface for managing extensions.
+
+Source code: <https://github.com/dect-e/nerd/>
+
+## Sync extensions to FieldPOC
+
+Nerd has an HTTP endpoint generation a FieldPOC compatible extensions file.
+
+You can adopt the follwing NixOS configuration snipped.
+It downloads the JSON file, copies it to the location FieldPOC expects the extensions and reload FieldPOC.
+
+```
+systemd.services.fieldpoc-nerd = {
+wantedBy = ["multi-user.target"];
+startAt = "*-*-* *:*:00";
+script = let
+  reloadScript = pkgs.writeText "reload" ''
+    spawn ${pkgs.inetutils}/bin/telnet localhost 9437
+    expect "> "
+    send "reload\n"
+    expect "> "
+    send "exit\n"
+    expect "disconnecting"
+  '';
+in ''
+  ${pkgs.curl}/bin/curl https://nerd.example.com/export.json\?event=1 > /etc/fieldpoc/extensions.json
+
+  ${pkgs.expect}/bin/expect ${reloadScript}
+'';
+};
+```
diff --git a/mkdocs.yml b/mkdocs.yml
index 3199190..106f1d5 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -21,3 +21,5 @@ nav:
   - Operation:
     - operation/claim-dect-extension.md
     - operation/troubleshooting.md
+  - Extend:
+    - extension/nerd.md