Hi Tim,
Great ideas. All sound good. I like the revised first header (I was worried about the length).
<menu name="Velocity"> <item name="Home" /> <item name="Quick Start" /> <item name="Web Applications" /> <item name="News & Sites" /> <item name="FAQ" /> </menu>
I like the JIRA idea too. I'd support a move to this. I haven't heard from Geir in a while.
Personally, I'm going to focus on the docs first - one thing at a time. The RoadMap might be a good next step - I'll throw my committer weight behind JIRA after that. (whatever that means :-)
WILL
----- Original Message ----- From: "Tim Colson (tcolson)" <[EMAIL PROTECTED]>
To: "Velocity Developers List" <[email protected]>
Sent: Friday, May 06, 2005 10:44 AM
Subject: RE: site table of contents
NEW XDOCS: * Getting Starting with Web Applications
+1 -- I would suggestion "mentioning" VelocityServlet only to say, "VelocityViewServlet replaces VelocityServlet. Don't use VelocityServlet, it's old crufty and deprecated... and if you ask about it on the mailing list...we'll tell you to read this: Don't use it!" <grin>
* TODO (convert to a Road Map)
I had suggested we move over to Jira, had positive feedback on that -- just no word from Geir (I emailed him offlist, still no official response here, but my understanding is that he wouldn't mind.)
We could put in the infrastructure@ request to move... and then leverage the Jira Roadmap feature.
http://jira.atlassian.com/browse/JRA?report=com.atlassian.jira.plugin.sy stem.project:roadmap-panel
I think we'd still want a page with a high-level Summary, but the Jira Roadmap is a great communication tool. And I'd put this into the Wiki.
NEW WIKI PAGES MOVE TO WIKI FROM DOCS
+1 -- I sometimes think SVN should just contain code + docs + examples... and most everything else move to the wiki where it's easier (in my opinion as a non-committer) to make updates. Sometimes. Not always. ;-)
REMOVE ENTIRELY * Specification (out of date, no one cares) * Migration to Velocity (WebMacro conversion - who uses WM?) * Contributors (very out of date)
+1
A simpler left-hand-navigation might be nice too. Less options so maybe folks will find (and read) what they need to before coming to the list.
<menu name="Getting Started">
<item name="Overview" />
<item name="Getting Started" />
<item name="Web Applications" />
<item name="Download" /> +
<item name="Install" />
<item name="Design" />
<item name="FAQ (Wiki)" /> *
</menu>
-1 on duplicating "Getting Started" as the header and a sub-head.
How about:
<menu name="Velocity"> <item name="Home" /> <item name="Quick Start" /> <item name="Web Applications" /> <item name="News & Sites" /> <item name="FAQ" /> </menu>
I'm thinking on the Home page leave "What is" from the main page, and add first heading of "Getting Started". Move news and powered by stuff onto the "News & Sites" page. Move "Design" down into the Docs menu, and rename to "Architecture". Put Download & Install stuff into "Quick Start".
BTW -- we ought to use a more direct link to downloads http://jakarta.apache.org/site/downloads/downloads_velocity-engine.cgi
Cheers, Timo
--------------------------------------------------------------------- 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]
