Thank Brett, I'll do my best.
In the first part, where I explain basic concepts, I sometimes
reproduce some of the already existing content but I always try  to
make the explanations clearer and add some details. Sometimes the
existing documentation is good but presented in a very rude way. And
lets not forget that a tutorial promotes a natural reading order,
which is very important to not confuse new users.

Other then that, I don't think I will take a lot of already existing content.


On 3/19/06, Brett Porter <[EMAIL PROTECTED]> wrote:
> I plan to take a look when I get some time. The important things I'd
> keep in mind:
> - don't just reproduce documentation that already exists (like
> installation instructions). The last attempt at a tutorial on the wiki
> did this and then just petered out as it wasn't very useful. This
> doesn't appear to be the case here, just a thing to keep in mind.
> - have in the back of your mind how you'd integrate it into the project
> web site. This should give a structure that facilitates doing so later.
>
> Thanks!
> - Brett
>
> Alexandre Poitras wrote:
> > Well I don't know if anyone has noticed but I have been working on
> > some Maven 2 documentation lately
> > http://docs.codehaus.org/display/MAVENUSER/The+Maven+2+tutorial
> >
> > I would like to hear your comments and suggestions since I am planning
> > to try to finish it in the coming weeks. In my opinion, the format is
> > more user-friendly at first then the sparsed documentation currently
> > available. What do you think?
> >
> > --
> > Alexandre Poitras
> > Québec, Canada
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: [EMAIL PROTECTED]
> > For additional commands, e-mail: [EMAIL PROTECTED]
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: [EMAIL PROTECTED]
> For additional commands, e-mail: [EMAIL PROTECTED]
>
>


--
Alexandre Poitras
Québec, Canada

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to