Properly document my source code

I spent tonight putting together an initial version of a JSDoc TextMate bundle. The easier something is to do, the more likely you are to do it. So now adding JSDoc comments are easier for me to add, so now to see how I take to implementing them…

I’ve been looking at Natural Docs as an alternative to the traditional JavaDoc-based solutions. It’s appealing that it’s an identical syntax and parser for various languages. After a close look though, I don’t think it’s for me. Because of its nature, it’s a little too freeform for me.

Maybe if I were already experienced at documenting code, then I’d be more comfortable with the overwhelming flexibility, but until then I’m going to focus on JSDoc and maybe the new ASDoc by building TextMate bundles.