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

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

     [ https://issues.apache.org/jira/browse/MNG-6923?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Paul Johnson updated MNG-6923:
------------------------------
    Description: 
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 getting started 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.

  was:
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 getting 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.


> 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
>            Priority: Trivial
>              Labels: documentation
>
> 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 getting started 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)