Re: 5.4-alpha-2 API docs

2013-01-06 Thread Howard Lewis Ship
Sounds like someone's volunteering? Docco documentation has a nice philosophical basis: you should be proud of your code, not hide the implementations. Yes, it is a challenge, and JavaScript/CoffeeScripts more wild, inclusive approach makes it a challenge. Is there a tool where we could put in pla

Re: 5.4-alpha-2 API docs

2013-01-06 Thread Bob Harner
Maybe it's just me, but I find the docco.coffee documentation format too linear and not very easy to follow. I much prefer the more organized, structured style of documentation like http://api.jquery.com/ uses. Regardless, it's great to see some real JavaScript documentation starting to emerge! O

5.4-alpha-2 API docs

2013-01-03 Thread Howard Lewis Ship
Also, I've recently changed the build to generate CoffeeScript documentation as well as JavaDocs. Here's a preview based on 5.4-alpha-2: http://people.apache.org/~hlship/t5api/ I like having this launch page as a step before jumping into the CoffeeScript documentation or JavaDocs ... especially b