You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@maven.apache.org by Tony Steele <to...@bbc.co.uk> on 2005/11/08 15:42:07 UTC
RE: [m2] Guide to creating archetypes
Please update website, my biggest problem is finding out how to do
things.
Tony
-----Original Message-----
From: Alexander Hars [mailto:do.not.reply@inventivio.com]
Sent: 08 November 2005 12:53
To: Maven Users List
Subject: Guide to creating archetypes
Hi,
Two weeks ago I wrote a significantly expanded Guide to Creating
Archetypes. It was immediately posted to CVS, but it is still not
available on the website.
Is there some reason why the Maven2 site is not updated regularly (last
update was 10/21). Shouldn't it be very easy using Maven2?
I am sure that lots of improvements have been made to the documentation
in the last weeks.
The documentation is really essential for all us newbies to Maven2 and
it would help very much if you could update the site.
Thank you very much
Alexander
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
http://www.bbc.co.uk/
This e-mail (and any attachments) is confidential and may contain
personal views which are not the views of the BBC unless specifically
stated.
If you have received it in error, please delete it from your system.
Do not use, copy or disclose the information in any way nor act in
reliance on it and notify the sender immediately. Please note that the
BBC monitors e-mails sent or received.
Further communication will signify your consent to this.
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
RE: [m2] doc suggestions (was Guide to creating archetypes)
Posted by Jeff Jensen <je...@upstairstechnology.com>.
http://jira.codehaus.org/browse/MNG-1479
Thanks Jason.
Quoting Jason van Zyl <ja...@maven.org>:
> On Tue, 2005-11-08 at 22:01 -0600, Jeff Jensen wrote:
> > Besides the multi-module doc, my experience wishes for the POM entry
> > descriptions - some are too vague. More detail (what is it for/why would
> > you use it, how to use it), examples, valid values, etc. would help a lot.
> >
> > I think the project descriptor has big potential as a solid reference
> > vehicle, with the added info. I would value that more than many of the
> > "guides".
> >
> > For a simple example, the <packaging> element doesn't describe valid
> values,
> > so a search begins to learn them. Viewing the schema doesn't help, as the
> > packaging type is "string". Additionally, I think the phrase "type of
> > artifact" is not intuitive to newbies, so listing the valid values would
> > bring contextual explanation, as well as their definition.
>
> Good idea, can you capture this in JIRA please.
>
> > HTH, and thanks for asking.
> >
> >
> > -----Original Message-----
> > From: Jason van Zyl [mailto:jason@maven.org]
> > Sent: Tuesday, November 08, 2005 9:10 AM
> > To: Maven Users List
> > Subject: RE: [m2] Guide to creating archetypes
> >
> > [snip]
> >
> > Anything in particular that's missing from the guides or introductory
> > material? Also check the JIRA components for documentation as I know there
> > are guides like the multi-project guide that are in demand and it's noted
> in
> > JIRA. You can also vote on issues which lets us know what you guys want
> most
> > which lets us focus our time better on writing what's most desired.
> >
> > [snip]
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> > For additional commands, e-mail: users-help@maven.apache.org
> >
> >
> --
> jvz.
>
> Jason van Zyl
> jason at maven.org
> http://maven.apache.org
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
RE: [m2] doc suggestions (was Guide to creating archetypes)
Posted by Jason van Zyl <ja...@maven.org>.
On Tue, 2005-11-08 at 22:01 -0600, Jeff Jensen wrote:
> Besides the multi-module doc, my experience wishes for the POM entry
> descriptions - some are too vague. More detail (what is it for/why would
> you use it, how to use it), examples, valid values, etc. would help a lot.
>
> I think the project descriptor has big potential as a solid reference
> vehicle, with the added info. I would value that more than many of the
> "guides".
>
> For a simple example, the <packaging> element doesn't describe valid values,
> so a search begins to learn them. Viewing the schema doesn't help, as the
> packaging type is "string". Additionally, I think the phrase "type of
> artifact" is not intuitive to newbies, so listing the valid values would
> bring contextual explanation, as well as their definition.
Good idea, can you capture this in JIRA please.
> HTH, and thanks for asking.
>
>
> -----Original Message-----
> From: Jason van Zyl [mailto:jason@maven.org]
> Sent: Tuesday, November 08, 2005 9:10 AM
> To: Maven Users List
> Subject: RE: [m2] Guide to creating archetypes
>
> [snip]
>
> Anything in particular that's missing from the guides or introductory
> material? Also check the JIRA components for documentation as I know there
> are guides like the multi-project guide that are in demand and it's noted in
> JIRA. You can also vote on issues which lets us know what you guys want most
> which lets us focus our time better on writing what's most desired.
>
> [snip]
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>
--
jvz.
Jason van Zyl
jason at maven.org
http://maven.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
RE: [m2] doc suggestions (was Guide to creating archetypes)
Posted by Jeff Jensen <je...@upstairstechnology.com>.
Besides the multi-module doc, my experience wishes for the POM entry
descriptions - some are too vague. More detail (what is it for/why would
you use it, how to use it), examples, valid values, etc. would help a lot.
I think the project descriptor has big potential as a solid reference
vehicle, with the added info. I would value that more than many of the
"guides".
For a simple example, the <packaging> element doesn't describe valid values,
so a search begins to learn them. Viewing the schema doesn't help, as the
packaging type is "string". Additionally, I think the phrase "type of
artifact" is not intuitive to newbies, so listing the valid values would
bring contextual explanation, as well as their definition.
HTH, and thanks for asking.
-----Original Message-----
From: Jason van Zyl [mailto:jason@maven.org]
Sent: Tuesday, November 08, 2005 9:10 AM
To: Maven Users List
Subject: RE: [m2] Guide to creating archetypes
[snip]
Anything in particular that's missing from the guides or introductory
material? Also check the JIRA components for documentation as I know there
are guides like the multi-project guide that are in demand and it's noted in
JIRA. You can also vote on issues which lets us know what you guys want most
which lets us focus our time better on writing what's most desired.
[snip]
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
RE: [m2] Guide to creating archetypes
Posted by Jason van Zyl <ja...@maven.org>.
On Tue, 2005-11-08 at 14:42 +0000, Tony Steele wrote:
> Please update website,
The site is updated very frequently. We try to keep it current with the
changes made to the documentation.
> my biggest problem is finding out how to do
> things.
Anything in particular that's missing from the guides or introductory
material? Also check the JIRA components for documentation as I know
there are guides like the multi-project guide that are in demand and
it's noted in JIRA. You can also vote on issues which lets us know what
you guys want most which lets us focus our time better on writing what's
most desired.
> Tony
> -----Original Message-----
> From: Alexander Hars [mailto:do.not.reply@inventivio.com]
> Sent: 08 November 2005 12:53
> To: Maven Users List
> Subject: Guide to creating archetypes
>
>
> Hi,
>
> Two weeks ago I wrote a significantly expanded Guide to Creating
> Archetypes. It was immediately posted to CVS, but it is still not
> available on the website.
>
> Is there some reason why the Maven2 site is not updated regularly (last
> update was 10/21). Shouldn't it be very easy using Maven2?
> I am sure that lots of improvements have been made to the documentation
>
> in the last weeks.
>
> The documentation is really essential for all us newbies to Maven2 and
> it would help very much if you could update the site.
>
> Thank you very much
> Alexander
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>
> http://www.bbc.co.uk/
>
> This e-mail (and any attachments) is confidential and may contain
> personal views which are not the views of the BBC unless specifically
> stated.
> If you have received it in error, please delete it from your system.
> Do not use, copy or disclose the information in any way nor act in
> reliance on it and notify the sender immediately. Please note that the
> BBC monitors e-mails sent or received.
> Further communication will signify your consent to this.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>
--
jvz.
Jason van Zyl
jason at maven.org
http://maven.apache.org
happiness is like a butterfly: the more you chase it, the more it will
elude you, but if you turn your attention to other things, it will come
and sit softly on your shoulder ...
-- Thoreau
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
Re: [m2] Guide to creating archetypes
Posted by "ir. ing. Jan Dockx" <ja...@mac.com>.
On 8 Nov 2005, at 15:42, Tony Steele wrote:
> Please update website, my biggest problem is finding out how to do
> things.
>
> Tony
>
That's one for my sigs! :-)
"[…] my biggest problem is finding out how to do things."
(in a mail on the Maven Users List)