I agree. Javadoc is archaic. Search would be huge. On Fri, May 27, 2011 at 7:25 PM, Kevin Wright <[email protected]> wrote: > > On May 28, 2011 1:39 AM, "Alexey Zinger" <[email protected]> wrote: >> >> Isn't that why we have doclets? Personally, I rarely find current >> standard doclets lacking. >> > > Not really, I'm thinking more along the lines of: > > - JavaScript-based searching > - full CSS layout > - Redesigned look and feel > - In-place expansion of a method definition when clicking on it to see more > detail > - All of the above by default, not just a latent possibility for > customising, repeatedly, for each and every project > - Something that might plausibly have been designed within the last decade > - etc. > >> 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. > > -- > 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.
