I seeded the skeleton of the users guide. You can check out the
workspace by:
cvs -d:$CVSROOT_JAVANET co jax-ws/guide
The document source is in docs/ folder, and you can generate docs by
using "ant doc", and push that to java.net by "ant publish". It will go
to
http://jax-ws.dev.java.net/guide/
The files are basically HTML, but it has a few custom tag sets (just
like release notes) for TOC generation and permalinks.
The custom tags and the build process is designed to allow us lengthy
documents. In comparison, release note templates are designed for
writing a relatively shorter document.
The plan is to use this to capture documentations on advanced topics,
such as writing tubes or using RI specific features, which are currently
scattered around blogs of various people.
--
Kohsuke Kawaguchi
Sun Microsystems kohsuke.kawaguchi_at_sun.com