Hey everybody,
Having survived a difficult (if profitable) busy period, I've now started an
ambitious rework of the Velocity site. Here's the revisions I'm considering.
Any comments, particularly on the Table of Contents? The goal is to make it
easier for new users to get started, to move community content to the Wiki, and
to update/remove out-of-date info.
Appreciate any thoughts.
Best,
WILL
OVERVIEW
----------------
NEW XDOCS:
* Getting Starting with Web Applications
REVISE SUBSTANTIALLY
* TODO (convert to a Road Map)
* Make software docs correspond to released version 1.4
NEW WIKI PAGES
* Featured Articles & Books
- links to books and magazine articles on Velocity
* Community articles
- includes all case studies/comparisons currently in xdocs
* Committers
* Documentation Standards
MOVE TO WIKI FROM DOCS
- YMTD
- JSP vs. Velocity
- VM/WM Differences
- XMLC vs. Velocity
REMOVE ENTIRELY
* Specification (out of date, no one cares)
* Migration to Velocity (WebMacro conversion - who uses WM?)
* Contributors (very out of date)
CONTENTS
----------------
* wiki content
+ outside content
<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>
<menu name="Docs (Velocity 1.4)">
<item name="User's Guide (English)" />
<item name="Developer's Guide" />
<item name="VTL Reference Guide" />
<item name="Javadoc" />
<item name="Change Log" />
<item name="License" />
</menu>
<menu name="Tools">
<item name="Velocity Tools" />
<item name="Anakia : XML->doc tool" />
<item name="Texen : text generation" />
<item name="DVSL : XML xformation" />
<item name="Veltag : JSP taglib" />
<item name="Editors and IDEs" />
</menu>
<menu name="Community">
<item name="Wiki" /> *
<item name="Powered By Velocity" /> *
<item name="Articles and Books" /> *
<item name="Get Involved" /> *
<item name="Mailing Lists" /> *
</menu>
<menu name="Developers">
<item name="Source Code Repository" /> +
<item name="Nightly Snapshot" /> +
<item name="Road Map" /> *
<item name="Coding Standards" /> *
<item name="Documentation Standards" /> *
<item name="Issues" /> +
</menu>
<menu name="Translations">
<item name="Site (Japanese)" /> +
<item name="User's Guide (Finnish)" />
<item name="User's Guide (French)" />
<item name="User's Guide (Spanish)" />
</menu>
