Hi Apophis - for the ones that have script code in them, you can add a comment to the start of the script. You can use that method to add some descriptions in there.

The way you do it is to put the comment inside of a /* */ block just after the script: statement.

See here for an example:
http://moi3d.com/forum/index.php?webtag=MOI&msg=1022.13

- Michael