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.
