On 30/03/2007, at 11:19 AM, Jeff Jensen wrote:
So what are the plans for what each would contain - Maven site and
wiki?
Would Maven site contain only the generated tool docs (e.g. reports
like
Javadoc, PMD) and would the wiki contain only hand-written user docs?
I'd see the current site staying as it is (although we could work on
better provision of the tools stuff again).
We would have cookbook subsections of the site which would be the
MAVENUSER and similar spaces drawn in under the user guides section.
The MAVEN space would be arranged and brought under the developer
documentation section and used for design proposals.
What I can't understand by just looking at those examples is how
was all
that content created? Did a "mvn site" run gen some and the hand
created
wiki pages link to it?
It's all created in confluence, and using the autoexport plugin it
regularly spits out static html. They use a template to produce the
look and feel. If you hit the edit links you can see the original
confluence system.
No argument - those are nice sites. Just not understanding yet the
Maven
plans for wiki/site usage. My fear, obviously, is continued
"separate"
works, as some people I helped with Maven have a "not happy-out-of-
the-box
experience", which includes scattered docs - I always have to give
them
multiple URLs for info and/or they keep Googling for answers.
If you plan to integrate Maven site and the wiki so well like the
examples
you provided, then the user sees them as one source. Very nice.
That's the theory :) Thanks for the feedback!
- Brett
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
