Add comments to what the scripted LUA functions do

[EmosewaMC]

In an attempt to document the known LUA scripting functions, Ive used context clues and variable names to write some brief descriptions of what these functions do, what their parameters mean, and link to an example of where the function is used.

Also mac is amazing and slams .DS_Store files in directories so im ignoring those

[Xiphoseer]

I know this isn't the first PR that does it like that, but I'm generally not a fan of using the Line Blocks feature (lines starting with |) to emulate nested/structured lists if we don't need to. I'd prefer to use sth like Definition Lists, optionally with custom CSS if there's too much margin between lines or so.

For LUA specifically, I added

Docs/requirements.txt

Line 5 in 0eaf1c0

-e git+https://github.com/pieterlexis/sphinx-lua.git#egg=sphinx-lua

a while back, which isn't actually used yet and may make be even more useful (looks better, adds linkable heading ids)

[Xiphoseer]

Also mac is amazing and slams .DS_Store files in directories so im ignoring those

Yeah, opening a zip someone built on mac is always fun too 😄. I'm fine with merging this in here or as a separate PR.