Hen,
How about doing mockups in the wiki? Of the actual layout, then
people can tool around and you can flesh out what you're thinking.
On 25 May 07, at 2:02 PM 25 May 07, Henri Yandell wrote:
I didn't notice any threads on the doc organization topic, so thought
I'd start one. Apologies if I missed the right place, [EMAIL PROTECTED] is the
noisiest list I'm on.
Compare and contrast:
http://maven.apache.org/guides/
and
http://httpd.apache.org/docs/2.2/
---
Firstly, there is no real Maven documentation home page. It's a part
of the front page, which clashes with the sheer amount of space that
news, announcement and other things need. So suggested step 1: We need
a documentation page.
Secondly, it's obvious that much of the httpd page concerns mod_foos
that are included by default. With Maven, these plugin documentation
pages are _much_ harder to find. They're not even listed under
documentation but involve you having to know that you want to use a
plugin and then go look at its docs. So suggested step 2: Plugin
documentation needs to be folded into main documentation.
Will add more as I go; I need to dig through the wiki sprawl to
understand how this is being solved; I'm sure the above isn't news.
Hen
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Thanks,
Jason
----------------------------------------------------------
Jason van Zyl
Founder and PMC Chair, Apache Maven
jason at sonatype dot com
----------------------------------------------------------
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
