I kinda agree that JavaDocs should be at the top. However, to prevent the Quick Links from becoming the Big Long List of Links, I think that leaving the source-xref down below would be fine. Especially since I typically use the source-xref with the unit test xref to see how the source is used...
Eric > -----Original Message----- > From: Jason van Zyl [mailto:[EMAIL PROTECTED] > Sent: Thursday, December 18, 2003 10:56 PM > To: Maven Users List > Subject: Re: Maven Site Usability > > > On Thu, 2003-12-18 at 16:29, Chad McHenry wrote: > > One thing I'd like to see changed is having "JavaDocs" and > "Source Xref" > > promoted from being "Project Reports". I would consider > these more than > > just reports: they are significant documentation! There's even a > > "JavaDoc Report" to emphasize the point! > > Would you like to see JavaDocs in the quick links section? Chris > Stevenson also suggested this. As it is a pretty hot item it could be > moved into the quick links section. This is the kind of feed > I'm looking > for. > > > ...Chad > > > > Jason van Zyl wrote: > > > > >Howdy, > > > > > >Prompted by Chris Stevenson Bob and I have started playing > around with > > >the Maven generated site in order to make it easier to > navigate and more > > >useful. Currenlty the book I'm working with is Homepage > Usability by > > >Jakob Nielsen: > > > > > > >http://www.amazon.com/exec/obidos/tg/detail/-/073571102X/qid= > 1071679585/sr=1-1/ref=sr_1_1/104-5601731-6202321?v=glance&s=books > > > > > >There are 113 recommendations so I'm slowly working > through them to see > > >what makes sense and what can be applied to the Maven > generated site. > > > > > >As a simple start we've tried to make the site look better > and not be so > > >much a punch in the face when you first see it. Of course, this is > > >purely subjective but we'll refine the design as we go. > > > > > >On the main Maven site now you'll notice that there is a > "Quick Links" > > >section. Currently I have this hardcoded into Maven's > navigation.xml but > > >it is something that I would like to generate for the > standard site. I > > >put a few entries there but suggestions for other hot items, like, > > >Javadoc, FAQs are welcome. We'll take the most popular > suggestions and > > >add them to the "Quick Links" section or whatever it ends up being > > >named. > > > > > >I've also started going through some of the reports and > the first one I > > >fixed was the dependencies report which Norbert pointed > out as being too > > >verbose. I agree so I changed the report back to its original terse > > >format. > > > > > >I'll be going through the rest of the reports, comparing > with some books > > >I picked up but user feed back here is most important. I'm > going to do a > > >little more tweaking then I'm going to release the plugin. > Hopefully > > >people can try deploying their own sites and asking their > users what > > >they feel is important. I think in a couple weeks with some good > > >feedback we can make some vast improvements to the > standard generated > > >site. I also have only looked at the site using > Mozilla/Linux so there > > >very well might be some problems with other platforms. > Please just pop a > > >note in JIRA if you see something that looks horrible. > > > > > >Take a peek at the work in progress: > > > > > >http://maven.apache.org/ > > > > > > > > > > > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [EMAIL PROTECTED] > > For additional commands, e-mail: [EMAIL PROTECTED] > -- > jvz. > > Jason van Zyl > [EMAIL PROTECTED] > http://tambora.zenplex.org > > In short, man creates for himself a new religion of a rational > and technical order to justify his work and to be justified in it. > > -- Jacques Ellul, The Technological Society > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [EMAIL PROTECTED] > For additional commands, e-mail: [EMAIL PROTECTED] --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
