Isn't that why we have doclets?  Personally, I rarely find current standard 
doclets lacking.

 
Alexey
2001 Honda CBR600F4i (CCS)
1998 Honda RS125 (CCS)
2002 Suzuki Bandit 1200S
http://weatherblackjack.appspot.com
http://azinger.blogspot.com
http://bsheet.sourceforge.net
http://wcollage.sourceforge.net



________________________________
From: Kevin Wright <[email protected]>
To: [email protected]
Sent: Friday, May 27, 2011 8:29 PM
Subject: [The Java Posse] JavaDoc due for an overhaul


Looking over the new JavaFX 2.0 API, I couldn't help but notice how dated the 
JavaDoc format now looks.

We started here: http://docstore.mik.ua/jdk/api/packages.html
and advanced to: http://download.oracle.com/javase/6/docs/api/

Then it all stopped, until...
we went from this: http://img.surfpack.com/img/thumbs/j/java.sun.com_favicon.jpg
to this: http://img.pho.to/img/thumbs/l/landingpad.oracle.com_favicon.jpg



Did innovation really stop at framesets?
Is a new favicon really the only change we can expect to JavaDoc?

There's so much potential here for a revised design, some search capabilities, 
a spot of script even!
Am I alone in thinking this?



-- 
Kevin Wright

gtalk / msn : [email protected]
mail: [email protected]

vibe / skype: kev.lee.wright
quora: http://www.quora.com/Kevin-Wright
twitter: @thecoda


"My point today is that, if we wish to count lines of code, we should not 
regard them as "lines produced" but as "lines spent": the current conventional 
wisdom is so foolish as to book that count on the wrong side of the ledger" ~ 
Dijkstra

-- 
You received this message because you are subscribed to the Google Groups "The 
Java Posse" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/javaposse?hl=en.

-- 
You received this message because you are subscribed to the Google Groups "The 
Java Posse" group.
To post to this group, send email to [email protected].
To unsubscribe from this group, send email to 
[email protected].
For more options, visit this group at 
http://groups.google.com/group/javaposse?hl=en.

Reply via email to