hmm, yeah a readme would be also a useful thing, because then of course the bot can build out its code based on that, but I was thinking just to do it on a file by file basis at the beginning to get further.

Ah, okay. How about JSDoc style comments?