From 3d484211a5b485fa40f22ebd58006ad64d4c4c3e Mon Sep 17 00:00:00 2001
From: jacqueline <me@jacqueline.id.au>
Date: Thu, 29 Aug 2024 17:20:55 +1000
Subject: [PATCH] Add reference doc regen instructions

---
 tools/luals-gendoc/README.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 tools/luals-gendoc/README.md

diff --git a/tools/luals-gendoc/README.md b/tools/luals-gendoc/README.md
new file mode 100644
index 00000000..b676aa16
--- /dev/null
+++ b/tools/luals-gendoc/README.md
@@ -0,0 +1,20 @@
+# Prerequisites
+
+ - lua-language-server
+ - a Lua interpreter version >= 5.2
+
+# Regenerating the Lua reference docs
+
+1. Invoke `lua-language-server` to parse our stubs, generating json output:
+
+```
+$ lua-language-server --doc=../../luals-stubs
+```
+
+2. The output will include the path to the raw json data. This will be a path like '/home/jacqueline/Development/lua-language-server/log/doc.json'. Pipe this file to `gendoc.lua`. The output will be quite long; consider piping to less for testing.
+
+```
+$ cat /home/jacqueline/Development/lua-language-server/log/doc.json | ./gendoc.lua | less
+```
+
+3. If updating the public-facing docs on cooltech.zone, place the resulting output in 'content/tangara/docs/lua/reference.txt'.