Well, it's still work in progress apparently, but you really should describe return types, arguments, functions, types, etc. It helps in the long run for when you may have potential users. Just a description of the module isn't enough in most cases. For example, your AI 'sub object' is described at the top of the page basicly, but even given the simple (perhaps, it depends on the subject) function names there's not much information as to what they're going to do when called.
Just my opinion, you don't have to like it.
Just my opinion, you don't have to like it.