Skip to content

[MNG-6923] Getting started guide is a bit stale #8391

@jira-importer

Description

@jira-importer

Paul Johnson opened MNG-6923 and commented

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

How do I make my first Maven project?

 

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

$ mvn compile

1. [ERROR] Source option 5 is no longer supported. Use 7 or later.
1. [ERROR] Target option 5 is no longer supported. Use 7 or later.

 

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

 

$ mvn site

 

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.


No further details from MNG-6923

Metadata

Metadata

Assignees

No one assigned

    Labels

    priority:trivialCosmetic problem like misspelled words or misaligned text

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions