On 26 May 07, at 1:47 AM 26 May 07, Henri Yandell wrote:
Will do - not that I have much thought-wise yet. I also think the
current website and structure is not terrible; so to solve the
complaints we need to understand why people are complaining.
Some more thoughts
Go to maven.apache
Probably; maybe; I think I'm still playing catchup on understanding
the problem :)
On 5/25/07, Brett Porter <[EMAIL PROTECTED]> wrote:
Agreed. Here is how I imagine this being laid out:
- each specific example would be in a plugin that it related to,
making it possible to go to a plugin as a "r
Will do - not that I have much thought-wise yet. I also think the
current website and structure is not terrible; so to solve the
complaints we need to understand why people are complaining.
Some more thoughts
Go to maven.apache.org. Minor irritation - the visited links are
the same colo
Agreed. Here is how I imagine this being laid out:
- each specific example would be in a plugin that it related to,
making it possible to go to a plugin as a "reference" page if you
already know what you are doing and are looking to cut-and-paste
something in. eg. http://maven.apache.org/pl
I think so.
The separation of authoring is good - but there needs to be a good
"How do I do Xxx?" -> plugin lookup; and a good central FAQ for the
plugins.
ie) "How do I add java.awt.headless to my tests?"
That can then link over to the surefire page on system properties.
So categorise a big F
+1 on both. Important thing for "plugin documentation needs to be
folded into main documentation" though - I assume you mean this in a
logical way (ie, strong contextual links from the documentation to
the plugin documentation), and not a physical way?
- Brett
On 26/05/2007, at 4:02 AM, He
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
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:
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
