On 12/4/05, Steve Cohen <[EMAIL PROTECTED]> wrote: > > Phil Steitz wrote: > > On 12/4/05, Steve Cohen <[EMAIL PROTECTED]> wrote: > > > >>Henri Yandell wrote: > >> > >> > >>>I turn the navigation off on Maven projects. Can't stand the > >>>project-reports, project-info roll-ups that make it harder to find > >>>javadocs etc. > >> > >>Hear hear! Javadocs are not a "project report" for anyone who uses > >>these sites. This one we can't blame on Maven, though, can we? I > >>always assumed it was our setup of Maven. > >> > > > > What exactly is broken here? > > Sites that follow the instructions here > > http://jakarta.apache.org/commons/building.html > > or start with the sample nav here > > > http://svn.apache.org/repos/asf/jakarta/commons/proper/commons-build/trunk/navigation.xml.sample > > will link to current and previous release javadoc from the top level > > nav. Pretty much all maven-generated commons sites do this now. > > > > The real challenge is what Stephen mentioned and Brett responed to, > > which is how to maintain javadoc for past releases. Now these files > > have to be manually pushed out and links custom coded in > > navigation.xml. > > > > Phil > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [EMAIL PROTECTED] > > For additional commands, e-mail: [EMAIL PROTECTED] > > > > > > > You're missing the point here, Phil. It's working as someone intended, > I'm sure, but the location of Javadocs buried under "Project Reports" is > bad from an end-user usability perspective. Granted, consistency is a > good thing and frequent users may eventually learn, but it would be > better for javadocs to be a top-level menu item. The "Javadoc Report" > is a report and is in the right place but the Javadocs themselves are > misplaced.
It's trivial to just add a link to them in your navigation.xml file. See the FileUpload, IO or Validator sites for examples. -- Martin Cooper --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] > >
