I stumbled across a need for this while I was doing some updates to my Google Desktop Plugin (YourMP). If you’ve ever done any coding for GDS gadgets then you’ll know it uses JS. Now my documenting was pretty poor so I wanted to tidy it up and went hunting for the usual format.
But I did eventually find a nice selection of 5…
If you’re a Mac fanboy I’ll probably lose you at this point as you go running off to use this Mac-made open source project. Unfortunately its sh*t. Although Mac made it they don’t make their documentation as nice and easy as their systems. It reminded me of the heinous Amazon developer docs with excessive wordiness and fluff. JSDoc above told me everything on a single page – done. This spanned several pages going into minute detail on every possible usage. It does cover a lot more languages like Obj-C, Java, C, etc but although its also based on JavaDoc I don’t like its unusual syntax which is just slightly different to JSDoc and the likes. Why the “/*!” instead of “/**”?
It only exports HTML format too…
Get HeaderDoc (needs a login)
This looks nice – both the output and the formatting of the source document tags. It uses a more natural formatting rather than the usual tag method. Although it does support JavaDoc style tags its much nicer to use the Natural way of doing it. It supports a large number of languages such as C++, Python, Ruby, Java, etc.
Again it only exports in HTML or framed HTML formats but if thats all you’re after then its great.
Get Natural Docs
This is more of a specification and as such has no parsing utilities to output niceley formatted HTML. Its an interesting idea but its s similar to JSDoc that you wonder why they’re even bothering.
Yes – they’ve been building XML-based JS documentation for their new VisualStudio when it comes out. But as its Microsoft I’m sure we’ll all collectively not give a shit.
|Export||HTML, XML, XMI||HTML||HTML||None||HTML|
|Influence||JavaDoc||JavaDoc||Natural & JavaDoc||JavaDoc||JavaDoc|
No related posts.