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.
