You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@maven.apache.org by Alexandre Poitras <al...@gmail.com> on 2006/03/13 13:05:43 UTC

Documentation

Ok I am getting tired to hear Maven documentation is awful. It is such
a wonderful product, I really want to see it adopted massively. I  am
considered a good technical writer at my job So I want to give a hand
there. My question, is where should I start?
The urgent need right now seems to be a cohesive documentation trail à
la SUN, what do you think? By the way, I will need native english
speakers correction, my english is still far from perfect :)

--
Alexandre Poitras
Québec, Canada

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org


Re: Documentation

Posted by Alexandre Poitras <al...@gmail.com>.
Merci pour l'info!

On 3/14/06, Vincent Massol <vm...@pivolis.com> wrote:
> Raphael,
>
> If you're doing to be doing some serious editing, I really recommend that
> you use TimTam. It's an offline confluence editor that runs in Eclipse. It's
> really worth it. I've been increasing my productivity by tenfolds with it.
>
> Just an idea...
>
> -Vincent
>
> > -----Original Message-----
> > From: Piéroni Raphaël [mailto:raphaelpieroni@gmail.com]
> > Sent: mardi 14 mars 2006 10:05
> > To: Maven Developers List
> > Subject: Re: Documentation
> >
> > http://docs.codehaus.org/display/MAVENUSER/Home
> >
> > Here is the documentation wiki.
> >
> > I will upload tonite all i have on my private wiki. Which is only a
> > starting
> > point.
> >
> > Regards
> >
> > Raphaël
> >
> > 2006/3/14, Piéroni Raphaël <ra...@gmail.com>:
> > >
> > > Which wiki is the good one ?
> > > The one hosted by apache or the one hosted at codehaus ?
> > >
> > > And how difficult is it to have write access ?
> > >
> > > Regards,
> > >
> > > Raphaël
> > >
> > > 2006/3/14, Alexandre Poitras < alexandre.poitras@gmail.com>:
> > > >
> > > > Ok the Maven team already offer a wiki to help write documentation so
> > > > I guess we should start writing there. I will give it a try as soon as
> > > > possible.
> > > >
> > > > On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> > > > > Cool! My idea was to start a structured wiki like Wikipedia to be
> > able
> > > >
> > > > > to work as a team but I don't want to create another unreadable wiki
> > > > > like most Apache projects already have. It's great for development
> > > > > efforts but not enough for end users.
> > > > >
> > > > > I'll take a look at the discussion first and see from there. Do you
> > > > > have the link (Confliuence?) ?
> > > > >
> > > > > On 3/13/06, Piéroni Raphaël <ra...@gmail.com> wrote:
> > > > > > Hi Alexandre,
> > > > > >
> > > > > > There is actually a discussion about the improvement of the site
> > on
> > > > the dev
> > > > > > list.
> > > > > >
> > > > > > May you subscribe and participate ?
> > > > > >
> > > > > > I also created a Jira issue for a proposition of improvment:
> > > > > > http://jira.codehaus.org/browse/MNG-2143
> > > > > >
> > > > > > Regards,
> > > > > >
> > > > > > Raphaël
> > > > > >
> > > > > >
> > > > > > 2006/3/13, Wayne Fay <waynefay@gmail.com >:
> > > > > > >
> > > > > > > Alexandre, I'll be glad to help you in this effort, especially
> > > > with
> > > > > > > the difficult English bits. ;-)
> > > > > > >
> > > > > > > Wayne
> > > > > > >
> > > > > > >
> > > > > > > On 3/13/06, Alexandre Poitras <al...@gmail.com>
> > wrote:
> > > > > > > > Ok I am getting tired to hear Maven documentation is awful. It
> > > > is such
> > > > > > > > a wonderful product, I really want to see it adopted
> > massively.
> > > > I  am
> > > > > > > > considered a good technical writer at my job So I want to give
> > a
> > > > hand
> > > > > > > > there. My question, is where should I start?
> > > > > > > > The urgent need right now seems to be a cohesive documentation
> > > > trail à
> > > > > > > > la SUN, what do you think? By the way, I will need native
> > > > english
> > > > > > > > speakers correction, my english is still far from perfect :)
> > > > > > > >
> > > > > > > > --
> > > > > > > > Alexandre Poitras
> > > > > > > > Québec, Canada
> > > > > > > >
> > > > > > > >
> > > > ---------------------------------------------------------------------
> > > > > > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > > > > > For additional commands, e-mail: dev-help@maven.apache.org
> > > > > > > >
> > > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > > >
> > > > > --
> > > > > Alexandre Poitras
> > > > > Québec, Canada
> > > > >
> > > >
> > > >
> > > > --
> > > > Alexandre Poitras
> > > > Québec, Canada
> > > >
> > > > ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > For additional commands, e-mail: dev-help@maven.apache.org
> > > >
> > > >
> > >
>
>
>
>
>
>
> ___________________________________________________________________________
> Nouveau : téléphonez moins cher avec Yahoo! Messenger ! Découvez les tarifs exceptionnels pour appeler la France et l'international.
> Téléchargez sur http://fr.messenger.yahoo.com
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>


--
Alexandre Poitras
Québec, Canada

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org


RE: Documentation

Posted by Vincent Massol <vm...@pivolis.com>.
Raphael,

If you're doing to be doing some serious editing, I really recommend that
you use TimTam. It's an offline confluence editor that runs in Eclipse. It's
really worth it. I've been increasing my productivity by tenfolds with it.

Just an idea...

-Vincent

> -----Original Message-----
> From: Piéroni Raphaël [mailto:raphaelpieroni@gmail.com]
> Sent: mardi 14 mars 2006 10:05
> To: Maven Developers List
> Subject: Re: Documentation
> 
> http://docs.codehaus.org/display/MAVENUSER/Home
> 
> Here is the documentation wiki.
> 
> I will upload tonite all i have on my private wiki. Which is only a
> starting
> point.
> 
> Regards
> 
> Raphaël
> 
> 2006/3/14, Piéroni Raphaël <ra...@gmail.com>:
> >
> > Which wiki is the good one ?
> > The one hosted by apache or the one hosted at codehaus ?
> >
> > And how difficult is it to have write access ?
> >
> > Regards,
> >
> > Raphaël
> >
> > 2006/3/14, Alexandre Poitras < alexandre.poitras@gmail.com>:
> > >
> > > Ok the Maven team already offer a wiki to help write documentation so
> > > I guess we should start writing there. I will give it a try as soon as
> > > possible.
> > >
> > > On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> > > > Cool! My idea was to start a structured wiki like Wikipedia to be
> able
> > >
> > > > to work as a team but I don't want to create another unreadable wiki
> > > > like most Apache projects already have. It's great for development
> > > > efforts but not enough for end users.
> > > >
> > > > I'll take a look at the discussion first and see from there. Do you
> > > > have the link (Confliuence?) ?
> > > >
> > > > On 3/13/06, Piéroni Raphaël <ra...@gmail.com> wrote:
> > > > > Hi Alexandre,
> > > > >
> > > > > There is actually a discussion about the improvement of the site
> on
> > > the dev
> > > > > list.
> > > > >
> > > > > May you subscribe and participate ?
> > > > >
> > > > > I also created a Jira issue for a proposition of improvment:
> > > > > http://jira.codehaus.org/browse/MNG-2143
> > > > >
> > > > > Regards,
> > > > >
> > > > > Raphaël
> > > > >
> > > > >
> > > > > 2006/3/13, Wayne Fay <waynefay@gmail.com >:
> > > > > >
> > > > > > Alexandre, I'll be glad to help you in this effort, especially
> > > with
> > > > > > the difficult English bits. ;-)
> > > > > >
> > > > > > Wayne
> > > > > >
> > > > > >
> > > > > > On 3/13/06, Alexandre Poitras <al...@gmail.com>
> wrote:
> > > > > > > Ok I am getting tired to hear Maven documentation is awful. It
> > > is such
> > > > > > > a wonderful product, I really want to see it adopted
> massively.
> > > I  am
> > > > > > > considered a good technical writer at my job So I want to give
> a
> > > hand
> > > > > > > there. My question, is where should I start?
> > > > > > > The urgent need right now seems to be a cohesive documentation
> > > trail à
> > > > > > > la SUN, what do you think? By the way, I will need native
> > > english
> > > > > > > speakers correction, my english is still far from perfect :)
> > > > > > >
> > > > > > > --
> > > > > > > Alexandre Poitras
> > > > > > > Québec, Canada
> > > > > > >
> > > > > > >
> > > ---------------------------------------------------------------------
> > > > > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > > > > For additional commands, e-mail: dev-help@maven.apache.org
> > > > > > >
> > > > > > >
> > > > > >
> > > > >
> > > >
> > > >
> > > > --
> > > > Alexandre Poitras
> > > > Québec, Canada
> > > >
> > >
> > >
> > > --
> > > Alexandre Poitras
> > > Québec, Canada
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > For additional commands, e-mail: dev-help@maven.apache.org
> > >
> > >
> >


	

	
		
___________________________________________________________________________ 
Nouveau : téléphonez moins cher avec Yahoo! Messenger ! Découvez les tarifs exceptionnels pour appeler la France et l'international.
Téléchargez sur http://fr.messenger.yahoo.com

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org


Re: Documentation

Posted by Piéroni Raphaël <ra...@gmail.com>.
http://docs.codehaus.org/display/MAVENUSER/Home

Here is the documentation wiki.

I will upload tonite all i have on my private wiki. Which is only a starting
point.

Regards

Raphaël

2006/3/14, Piéroni Raphaël <ra...@gmail.com>:
>
> Which wiki is the good one ?
> The one hosted by apache or the one hosted at codehaus ?
>
> And how difficult is it to have write access ?
>
> Regards,
>
> Raphaël
>
> 2006/3/14, Alexandre Poitras < alexandre.poitras@gmail.com>:
> >
> > Ok the Maven team already offer a wiki to help write documentation so
> > I guess we should start writing there. I will give it a try as soon as
> > possible.
> >
> > On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> > > Cool! My idea was to start a structured wiki like Wikipedia to be able
> >
> > > to work as a team but I don't want to create another unreadable wiki
> > > like most Apache projects already have. It's great for development
> > > efforts but not enough for end users.
> > >
> > > I'll take a look at the discussion first and see from there. Do you
> > > have the link (Confliuence?) ?
> > >
> > > On 3/13/06, Piéroni Raphaël <ra...@gmail.com> wrote:
> > > > Hi Alexandre,
> > > >
> > > > There is actually a discussion about the improvement of the site on
> > the dev
> > > > list.
> > > >
> > > > May you subscribe and participate ?
> > > >
> > > > I also created a Jira issue for a proposition of improvment:
> > > > http://jira.codehaus.org/browse/MNG-2143
> > > >
> > > > Regards,
> > > >
> > > > Raphaël
> > > >
> > > >
> > > > 2006/3/13, Wayne Fay <waynefay@gmail.com >:
> > > > >
> > > > > Alexandre, I'll be glad to help you in this effort, especially
> > with
> > > > > the difficult English bits. ;-)
> > > > >
> > > > > Wayne
> > > > >
> > > > >
> > > > > On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> > > > > > Ok I am getting tired to hear Maven documentation is awful. It
> > is such
> > > > > > a wonderful product, I really want to see it adopted massively.
> > I  am
> > > > > > considered a good technical writer at my job So I want to give a
> > hand
> > > > > > there. My question, is where should I start?
> > > > > > The urgent need right now seems to be a cohesive documentation
> > trail à
> > > > > > la SUN, what do you think? By the way, I will need native
> > english
> > > > > > speakers correction, my english is still far from perfect :)
> > > > > >
> > > > > > --
> > > > > > Alexandre Poitras
> > > > > > Québec, Canada
> > > > > >
> > > > > >
> > ---------------------------------------------------------------------
> > > > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > > > For additional commands, e-mail: dev-help@maven.apache.org
> > > > > >
> > > > > >
> > > > >
> > > >
> > >
> > >
> > > --
> > > Alexandre Poitras
> > > Québec, Canada
> > >
> >
> >
> > --
> > Alexandre Poitras
> > Québec, Canada
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > For additional commands, e-mail: dev-help@maven.apache.org
> >
> >
>

Re: Documentation

Posted by Piéroni Raphaël <ra...@gmail.com>.
Which wiki is the good one ?
The one hosted by apache or the one hosted at codehaus ?

And how difficult is it to have write access ?

Regards,

Raphaël

2006/3/14, Alexandre Poitras <al...@gmail.com>:
>
> Ok the Maven team already offer a wiki to help write documentation so
> I guess we should start writing there. I will give it a try as soon as
> possible.
>
> On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> > Cool! My idea was to start a structured wiki like Wikipedia to be able
> > to work as a team but I don't want to create another unreadable wiki
> > like most Apache projects already have. It's great for development
> > efforts but not enough for end users.
> >
> > I'll take a look at the discussion first and see from there. Do you
> > have the link (Confliuence?) ?
> >
> > On 3/13/06, Piéroni Raphaël <ra...@gmail.com> wrote:
> > > Hi Alexandre,
> > >
> > > There is actually a discussion about the improvement of the site on
> the dev
> > > list.
> > >
> > > May you subscribe and participate ?
> > >
> > > I also created a Jira issue for a proposition of improvment:
> > > http://jira.codehaus.org/browse/MNG-2143
> > >
> > > Regards,
> > >
> > > Raphaël
> > >
> > >
> > > 2006/3/13, Wayne Fay <wa...@gmail.com>:
> > > >
> > > > Alexandre, I'll be glad to help you in this effort, especially with
> > > > the difficult English bits. ;-)
> > > >
> > > > Wayne
> > > >
> > > >
> > > > On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> > > > > Ok I am getting tired to hear Maven documentation is awful. It is
> such
> > > > > a wonderful product, I really want to see it adopted massively.
> I  am
> > > > > considered a good technical writer at my job So I want to give a
> hand
> > > > > there. My question, is where should I start?
> > > > > The urgent need right now seems to be a cohesive documentation
> trail à
> > > > > la SUN, what do you think? By the way, I will need native english
> > > > > speakers correction, my english is still far from perfect :)
> > > > >
> > > > > --
> > > > > Alexandre Poitras
> > > > > Québec, Canada
> > > > >
> > > > >
> ---------------------------------------------------------------------
> > > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > > For additional commands, e-mail: dev-help@maven.apache.org
> > > > >
> > > > >
> > > >
> > >
> >
> >
> > --
> > Alexandre Poitras
> > Québec, Canada
> >
>
>
> --
> Alexandre Poitras
> Québec, Canada
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>

Re: Documentation

Posted by Alexandre Poitras <al...@gmail.com>.
Ok the Maven team already offer a wiki to help write documentation so
I guess we should start writing there. I will give it a try as soon as
possible.

On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> Cool! My idea was to start a structured wiki like Wikipedia to be able
> to work as a team but I don't want to create another unreadable wiki
> like most Apache projects already have. It's great for development
> efforts but not enough for end users.
>
> I'll take a look at the discussion first and see from there. Do you
> have the link (Confliuence?) ?
>
> On 3/13/06, Piéroni Raphaël <ra...@gmail.com> wrote:
> > Hi Alexandre,
> >
> > There is actually a discussion about the improvement of the site on the dev
> > list.
> >
> > May you subscribe and participate ?
> >
> > I also created a Jira issue for a proposition of improvment:
> > http://jira.codehaus.org/browse/MNG-2143
> >
> > Regards,
> >
> > Raphaël
> >
> >
> > 2006/3/13, Wayne Fay <wa...@gmail.com>:
> > >
> > > Alexandre, I'll be glad to help you in this effort, especially with
> > > the difficult English bits. ;-)
> > >
> > > Wayne
> > >
> > >
> > > On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> > > > Ok I am getting tired to hear Maven documentation is awful. It is such
> > > > a wonderful product, I really want to see it adopted massively. I  am
> > > > considered a good technical writer at my job So I want to give a hand
> > > > there. My question, is where should I start?
> > > > The urgent need right now seems to be a cohesive documentation trail à
> > > > la SUN, what do you think? By the way, I will need native english
> > > > speakers correction, my english is still far from perfect :)
> > > >
> > > > --
> > > > Alexandre Poitras
> > > > Québec, Canada
> > > >
> > > > ---------------------------------------------------------------------
> > > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > > For additional commands, e-mail: dev-help@maven.apache.org
> > > >
> > > >
> > >
> >
>
>
> --
> Alexandre Poitras
> Québec, Canada
>


--
Alexandre Poitras
Québec, Canada

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org


Re: Documentation

Posted by Alexandre Poitras <al...@gmail.com>.
Cool! My idea was to start a structured wiki like Wikipedia to be able
to work as a team but I don't want to create another unreadable wiki
like most Apache projects already have. It's great for development
efforts but not enough for end users.

I'll take a look at the discussion first and see from there. Do you
have the link (Confliuence?) ?

On 3/13/06, Piéroni Raphaël <ra...@gmail.com> wrote:
> Hi Alexandre,
>
> There is actually a discussion about the improvement of the site on the dev
> list.
>
> May you subscribe and participate ?
>
> I also created a Jira issue for a proposition of improvment:
> http://jira.codehaus.org/browse/MNG-2143
>
> Regards,
>
> Raphaël
>
>
> 2006/3/13, Wayne Fay <wa...@gmail.com>:
> >
> > Alexandre, I'll be glad to help you in this effort, especially with
> > the difficult English bits. ;-)
> >
> > Wayne
> >
> >
> > On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> > > Ok I am getting tired to hear Maven documentation is awful. It is such
> > > a wonderful product, I really want to see it adopted massively. I  am
> > > considered a good technical writer at my job So I want to give a hand
> > > there. My question, is where should I start?
> > > The urgent need right now seems to be a cohesive documentation trail à
> > > la SUN, what do you think? By the way, I will need native english
> > > speakers correction, my english is still far from perfect :)
> > >
> > > --
> > > Alexandre Poitras
> > > Québec, Canada
> > >
> > > ---------------------------------------------------------------------
> > > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > > For additional commands, e-mail: dev-help@maven.apache.org
> > >
> > >
> >
>


--
Alexandre Poitras
Québec, Canada

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
For additional commands, e-mail: dev-help@maven.apache.org


Re: Documentation

Posted by Piéroni Raphaël <ra...@gmail.com>.
Hi Alexandre,

There is actually a discussion about the improvement of the site on the dev
list.

May you subscribe and participate ?

I also created a Jira issue for a proposition of improvment:
http://jira.codehaus.org/browse/MNG-2143

Regards,

Raphaël


2006/3/13, Wayne Fay <wa...@gmail.com>:
>
> Alexandre, I'll be glad to help you in this effort, especially with
> the difficult English bits. ;-)
>
> Wayne
>
>
> On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> > Ok I am getting tired to hear Maven documentation is awful. It is such
> > a wonderful product, I really want to see it adopted massively. I  am
> > considered a good technical writer at my job So I want to give a hand
> > there. My question, is where should I start?
> > The urgent need right now seems to be a cohesive documentation trail à
> > la SUN, what do you think? By the way, I will need native english
> > speakers correction, my english is still far from perfect :)
> >
> > --
> > Alexandre Poitras
> > Québec, Canada
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> > For additional commands, e-mail: dev-help@maven.apache.org
> >
> >
>

Re: Documentation

Posted by Wayne Fay <wa...@gmail.com>.
Alexandre, I'll be glad to help you in this effort, especially with
the difficult English bits. ;-)

Wayne


On 3/13/06, Alexandre Poitras <al...@gmail.com> wrote:
> Ok I am getting tired to hear Maven documentation is awful. It is such
> a wonderful product, I really want to see it adopted massively. I  am
> considered a good technical writer at my job So I want to give a hand
> there. My question, is where should I start?
> The urgent need right now seems to be a cohesive documentation trail à
> la SUN, what do you think? By the way, I will need native english
> speakers correction, my english is still far from perfect :)
>
> --
> Alexandre Poitras
> Québec, Canada
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>