RE: [m2] doc suggestions (was Guide to creating archetypes)

2005-11-09 Thread Jason van Zyl
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:[EMAIL PROTECTED] 
 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: [EMAIL PROTECTED]
 For additional commands, e-mail: [EMAIL PROTECTED]
 
 
-- 
jvz.

Jason van Zyl
jason at maven.org
http://maven.apache.org



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



RE: [m2] doc suggestions (was Guide to creating archetypes)

2005-11-09 Thread Jeff Jensen
http://jira.codehaus.org/browse/MNG-1479

Thanks Jason.


Quoting Jason van Zyl [EMAIL PROTECTED]:

 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:[EMAIL PROTECTED]
  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: [EMAIL PROTECTED]
  For additional commands, e-mail: [EMAIL PROTECTED]
 
 
 --
 jvz.

 Jason van Zyl
 jason at maven.org
 http://maven.apache.org



 -
 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]