[MNG-6923] Getting started guide is a bit stale
- Dominant language
- Java
- Stars
- 5.3k
- Forks
- 3.1k
- Avg merge
- 20h 42m
- Merged PRs (30d)
- 297
Description
**[Paul Johnson](https://issues.apache.org/jira/secure/ViewProfile.jspa?name=btpaul)** opened **[MNG-6923](https://issues.apache.org/jira/browse/MNG-6923?redirect=false)** 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?
```java
$ 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
```java
$ 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](https://issues.apache.org/jira/browse/MNG-6923?redirect=false)
Contributor guide
Research direction
Start with the getting-started guide at https://maven.apache.org/guides/getting-started/ and run its archetype, compile, and site commands. Check the reported source/target and Maven Site Plugin failures, then update the guide so a new user can complete the documented workflow without those errors.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- java
- Domain
- build-system, documentation
- Issue type
- Documentation
- Difficulty
- 3/5
- Estimated time
- 1-2 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 40/100