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] [Commented] (MNGSITE-290) Download and Install documentation is unclear
Date Wed, 13 Jul 2016 15:39:20 GMT

    [ https://issues.apache.org/jira/browse/MNGSITE-290?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15375218#comment-15375218
] 

Daniel Stone commented on MNGSITE-290:
--------------------------------------

I think part of it for me was that download links aren't usually named something technical,
and the bin one gave me some uncertainty because I wasn't sure what the bin extension meant,
so I went with the second one. Also, both were listed in the download list, so since they
were given the same visual importance, I assumed they had the same functional importance.

> 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
>   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