I've created an application called MorpheusDoc, which is responsible for auto-creation of Script Library documentation.
It's written in C# (.NET Framework needed) and it's based off JavaDoc, but a lot more simple.

I've written a short tutorial on GitHub Wiki (Readme.md).

Now we can add special comments above certain variables and functions, and it will create HTML or MD documentation out of it.

I think that comments as well as documentation look pretty nice and very readable, and we should use it.
This also forces some standards which is also very nice imho.

It's an alpha version so please write about any errors. Basic functionality works and I've tested it.

You can use it on files.slib to get the idea. It has one function and one constant documented. If function doesn't have comments, MorpheusDoc will grab it too, but it won't be able to guess the type of arguments and return value etc.