maven-issues mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Daniel Stone (JIRA)" <j...@apache.org>
Subject [jira] [Updated] (MNGSITE-290) Download and Install documentation is unclear
Date Fri, 08 Jul 2016 15:39:11 GMT

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

Daniel Stone updated MNGSITE-290:
---------------------------------
    Description: 
The maven installation documentation says to add "C:\Program Files\apache-maven-3.3.9\bin"
to your path. However, this directory does not exist in the most recent version.

UPDATE: Got this figured out, but the documentation is still unclear. When I tried to run
maven, I got the mysterious error, "Could not find or load main class org.codehaus.plexus.classworlds.launcher.Launcher".
After about an hour of googling, I found a stack overflow post that related to the binaries.
Turns out you need to download the binaries zip file and not the source one. 

As a user, the website is unclear on which to download. It doesn't say either way, and it
didn't register to me that I needed a particular one. To make it even worse, maven appears
to partially run when you try it with the src package. As a user, this has been a very frustrating
experience. It would be helpful if the binary files were highlighted, and the src files were
put in a separate container further down the page, or at least add a note saying which ones
you need to download. Most people probably don't care about the source. There's a stackoverflow
issue for the error I got when trying to run maven from the source instead of the binaries,
so this is a common issue for other people as well. http://stackoverflow.com/questions/11118237/maven-error-could-not-find-or-load-main-class-org-codehaus-plexus-classworlds-l

Also, in the installation documentation, it would be helpful to tell users to download the
binaries, and add a note saying something like, "If your unzipped package does not contain
a bin directory, you've downloaded the wrong package. Please go download the binaries zip
file instead. "

It's a simple thing, but this has made me not want to use Maven just from the difficulty of
getting it set up. It would be great if you guys had an installer, but at the very least,
could you update the docs to be more user friendly? It would take a minimum of effort and
it would improve your perceived user experience a lot.

  was:
The maven installation documentation says to add "C:\Program Files\apache-maven-3.3.9\bin"
to your path. However, this directory does not exist in the most recent version.

UPDATE: Got this figured out, but the documentation is still unclear. When I tried to run
maven, I got the mysterious error, "Could not find or load main class org.codehaus.plexus.classworlds.launcher.Launcher".
After about an hour of googling, I found a stack overflow post that related to the binaries.
Turns out you need to download the binaries zip file and not the source one. 

As a user, the website is unclear on which to download. It doesn't say either way, and it
didn't register to me that I needed a particular one. To make it even worse, maven appears
to partially run when you try it with the src package. As a user, this has been a very frustrating
experience. It would be helpful if the binary files were highlighted, and the src files were
put in a separate container further down the page, or at least add a note saying which ones
you need to download. Most people probably don't care about the source. There's a stackoverflow
issue for the error I got when trying to run maven from the source instead of the binaries,
so this is a common issue for other people as well. http://stackoverflow.com/a/19024073/2095953

Also, in the installation documentation, it would be helpful to tell users to download the
binaries, and add a note saying something like, "If your unzipped package does not contain
a bin directory, you've downloaded the wrong package. Please go download the binaries zip
file instead. "

It's a simple thing, but this has made me not want to use Maven just from the difficulty of
getting it set up. It would be great if you guys had an installer, but at the very least,
could you update the docs to be more user friendly? It would take a minimum of effort and
it would improve your perceived user experience a lot.


> Download and Install documentation is unclear
> ---------------------------------------------
>
>                 Key: MNGSITE-290
>                 URL: https://issues.apache.org/jira/browse/MNGSITE-290
>             Project: Maven Project Web Site
>          Issue Type: Bug
>         Environment: Windows 10
>            Reporter: Daniel Stone
>            Priority: Minor
>              Labels: Installation, Maven
>   Original Estimate: 1h
>  Remaining Estimate: 1h
>
> The maven installation documentation says to add "C:\Program Files\apache-maven-3.3.9\bin"
to your path. However, this directory does not exist in the most recent version.
> UPDATE: Got this figured out, but the documentation is still unclear. When I tried to
run maven, I got the mysterious error, "Could not find or load main class org.codehaus.plexus.classworlds.launcher.Launcher".
After about an hour of googling, I found a stack overflow post that related to the binaries.
Turns out you need to download the binaries zip file and not the source one. 
> As a user, the website is unclear on which to download. It doesn't say either way, and
it didn't register to me that I needed a particular one. To make it even worse, maven appears
to partially run when you try it with the src package. As a user, this has been a very frustrating
experience. It would be helpful if the binary files were highlighted, and the src files were
put in a separate container further down the page, or at least add a note saying which ones
you need to download. Most people probably don't care about the source. There's a stackoverflow
issue for the error I got when trying to run maven from the source instead of the binaries,
so this is a common issue for other people as well. http://stackoverflow.com/questions/11118237/maven-error-could-not-find-or-load-main-class-org-codehaus-plexus-classworlds-l
> Also, in the installation documentation, it would be helpful to tell users to download
the binaries, and add a note saying something like, "If your unzipped package does not contain
a bin directory, you've downloaded the wrong package. Please go download the binaries zip
file instead. "
> It's a simple thing, but this has made me not want to use Maven just from the difficulty
of getting it set up. It would be great if you guys had an installer, but at the very least,
could you update the docs to be more user friendly? It would take a minimum of effort and
it would improve your perceived user experience a lot.



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

Mime
View raw message