[TAPESTRY-2499] Reduce Frustration Experienced By "green" Maven User When Following the Tapestry Archetype Example

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 4.1
• Fix Version/s: 4.1.6
• Component/s: Examples
• Environment: documentation / example on the tapestry 4.1 webpage: http://tapestry.apache.org/tapestry4.1/tapestry-archetype/index.html
• Assignee: Andreas Andreou
• Reporter: Andrew Lenards
• Created: 02/Jul/08 18:57
• Updated: 02/Jul/08 22:01
• Resolved: 02/Jul/08 21:50

Description

I experienced an issue with getting the tapestry archetype to run using the specified command on the tapestry 4.1 page:

http://tapestry.apache.org/tapestry4.1/tapestry-archetype/index.html

I needed to add the remote repository get to the snapshot version to work along with using the -U option.

Since the example assumes that users may have just downloaded and installed Maven, it would be significantly helpful if these arguments were mentioned because if they're not (given my experience) maven will prompt them to choose an archetype. This will lead them way off course.

It should be a quick change. Maybe just:

If you experience that they archetype is not found, try the following:

mvn -U archetype:create -DarchetypeGroupId=org.apache.tapestry -DarchetypeArtifactId=tapestry-archetype -DremoteRepositories=http://people.apache.org/repo/m2-snapshot-repository/ -DarchetypeVersion=4.1.6-SNAPSHOT -DgroupId=com.example -DartifactId=myapp

(not sure if they line-continuation slashes are needed)

thanks