Use luals-stubs as the source of truth for docs, instead of maintaining

separate docs stubs

Includes introducing a cool new script to turn lua-language-server's
json output into markdown documentation.

1 files changed, 12 insertions, 0 deletions

diff --git a/luals-stubs/controls.lua b/luals-stubs/controls.lua
new file mode 100644
index 00000000..7034dc55
--- /dev/null
+++ b/luals-stubs/controls.lua
@@ -0,0 +1,12 @@
+--- @meta
+
+--- The `controls` module contains Properties relating to the device's physical
+--- controls. These controls include the touchwheel, the lock switch, and the
+--- side buttons.
+--- @class controls
+--- @field scheme Property The currently configured control scheme
+--- @field scroll_sensitivity Property How much rotational motion is required on the touchwheel per scroll tick.
+--- @field lock_switch Property  The current state of the device's lock switch.
+local controls = {}
+
+return controls