[jira] [Created] (MNG-6923) Getting started guide is a bit stale

["Paul Johnson (Jira)" <ji...@apache.org>]

Paul Johnson created MNG-6923:
---------------------------------

             Summary: Getting started guide is a bit stale
                 Key: MNG-6923
                 URL: https://issues.apache.org/jira/browse/MNG-6923
             Project: Maven
          Issue Type: Wish
            Reporter: Paul Johnson


WRT [https://maven.apache.org/guides/getting-started/]

First of all sorry if this is the wrong place to discuss, I don’t want to waste contributors time managing tickets, I did consider the mailing list but thought an issue seemed more appropriate.

I’m starting to write a Java library for a client and thought I had best refresh my understanding of the Java dependency / build management ecosystem so I figured I would run through the quick start guide.

One would hope this would be painless for newbies but sadly at almost every step fails.

For example on the first step
h3. How do I make my first Maven project?

 
{code:java}
$ mvn -B archetype:generate -DarchetypeGroupId=org.apache.maven.archetypes -DgroupId=com.mycompany.app -DartifactId=my-app

$ mvn compile

# [ERROR] Source option 5 is no longer supported. Use 7 or later.
# [ERROR] Target option 5 is no longer supported. Use 7 or later.
{code}
 

Obviously the fix is trivial and luckily for me I already know how to resolve it but others following along may not and will have to hunt around on the Internet to solve the problem.

If newbie sticks around and fixes the issues with compile phase then test phase works OK as does package, so next up in the guide is

 
{code:java}
$ mvn site
{code}
 

This spits out 220 lines of scary looking stuff (stack trace + error logging).

Again the fix is simple just specify modern version of maven site plug-in but I could forgive a newbie for saying bugger this and looking into gradle instead.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)