Small documentation improvement
Hi, I just started using Maven, and while trying to do so I got some problems finding the correct information. Here is a list of improvements that could help other people when learning Maven for the first time: * Eclipse guide (http://maven.apache.org/guides/mini/guide-ide-eclipse.html) - While it is included under the Documentation index, the average user will click on the Eclipse link under IDE Integration menu item. In this page (http://maven.apache.org/eclipse-plugin.html), you will be directed to external websites, probably missing the Eclipse guide, which contains vital information about setting the Maven repository in Eclipse. A link to the Eclipse guide in the Eclipse integration page is a must. - The Eclipse guide should mention that if you are using the M2Eclipse plugin, it is better to use mvn eclipse:m2eclipse when generating the project, as this will allow for correct dependency administration using the m2eclipse plugin. - The guide should also mention how you create the project files for Eclipse if you are working with a webapp, as in mvn -Dwtpversion=1.5 eclipse:m2eclipse. - Related to the two previous points, you need to activate the M2Eclipse dependency in Eclipse: Project Properties - J2EE Module dependencies for your webapp to see the m2eclipse dependencies. * Site documentation - How to generate pages in UTF-8? it may seem obvious, but it took a while on the search engines: ... plugins plugin artifactIdmaven-site-plugin/artifactId version2.0-beta-6/version configuration localesen/locales inputEncodingutf-8/inputEncoding outputEncodingutf-8/outputEncoding /configuration /plugin /plugins ... I Hope that someone can go over these simple things. It will really help new people get into Maven. See you! - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Small documentation improvement
For all intents, you can generally assume that this email will be lost to the void unless you file issue(s) in JIRA. While these kinds of suggestions are certainly appreciated, no one will do the job of transferring your comments from email to JIRA, and it is possible that the various developers responsible for the documentation improvements you are suggesting will not even see this email. Wayne On Mon, May 19, 2008 at 6:25 AM, Manel Clos [EMAIL PROTECTED] wrote: Hi, I just started using Maven, and while trying to do so I got some problems finding the correct information. Here is a list of improvements that could help other people when learning Maven for the first time: * Eclipse guide (http://maven.apache.org/guides/mini/guide-ide-eclipse.html) - While it is included under the Documentation index, the average user will click on the Eclipse link under IDE Integration menu item. In this page (http://maven.apache.org/eclipse-plugin.html), you will be directed to external websites, probably missing the Eclipse guide, which contains vital information about setting the Maven repository in Eclipse. A link to the Eclipse guide in the Eclipse integration page is a must. - The Eclipse guide should mention that if you are using the M2Eclipse plugin, it is better to use mvn eclipse:m2eclipse when generating the project, as this will allow for correct dependency administration using the m2eclipse plugin. - The guide should also mention how you create the project files for Eclipse if you are working with a webapp, as in mvn -Dwtpversion=1.5 eclipse:m2eclipse. - Related to the two previous points, you need to activate the M2Eclipse dependency in Eclipse: Project Properties - J2EE Module dependencies for your webapp to see the m2eclipse dependencies. * Site documentation - How to generate pages in UTF-8? it may seem obvious, but it took a while on the search engines: ... plugins plugin artifactIdmaven-site-plugin/artifactId version2.0-beta-6/version configuration localesen/locales inputEncodingutf-8/inputEncoding outputEncodingutf-8/outputEncoding /configuration /plugin /plugins ... I Hope that someone can go over these simple things. It will really help new people get into Maven. See you! - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Small documentation improvement
These do sound like good suggestions, though. I *think* Wayne is suggesting that you create a JIRA issue with your comments attached. That certainly sounds like a good idea to me (though I am not a Maven developer). It's also worth noting that Maven does have a wiki (see link on main page) where people can add useful information for other maven users without waiting for someone with svn access to do it for them. Regards, Simon Wayne Fay schrieb: For all intents, you can generally assume that this email will be lost to the void unless you file issue(s) in JIRA. While these kinds of suggestions are certainly appreciated, no one will do the job of transferring your comments from email to JIRA, and it is possible that the various developers responsible for the documentation improvements you are suggesting will not even see this email. Wayne On Mon, May 19, 2008 at 6:25 AM, Manel Clos [EMAIL PROTECTED] wrote: Hi, I just started using Maven, and while trying to do so I got some problems finding the correct information. Here is a list of improvements that could help other people when learning Maven for the first time: * Eclipse guide (http://maven.apache.org/guides/mini/guide-ide-eclipse.html) - While it is included under the Documentation index, the average user will click on the Eclipse link under IDE Integration menu item. In this page (http://maven.apache.org/eclipse-plugin.html), you will be directed to external websites, probably missing the Eclipse guide, which contains vital information about setting the Maven repository in Eclipse. A link to the Eclipse guide in the Eclipse integration page is a must. - The Eclipse guide should mention that if you are using the M2Eclipse plugin, it is better to use mvn eclipse:m2eclipse when generating the project, as this will allow for correct dependency administration using the m2eclipse plugin. - The guide should also mention how you create the project files for Eclipse if you are working with a webapp, as in mvn -Dwtpversion=1.5 eclipse:m2eclipse. - Related to the two previous points, you need to activate the M2Eclipse dependency in Eclipse: Project Properties - J2EE Module dependencies for your webapp to see the m2eclipse dependencies. * Site documentation - How to generate pages in UTF-8? it may seem obvious, but it took a while on the search engines: ... plugins plugin artifactIdmaven-site-plugin/artifactId version2.0-beta-6/version configuration localesen/locales inputEncodingutf-8/inputEncoding outputEncodingutf-8/outputEncoding /configuration /plugin /plugins ... I Hope that someone can go over these simple things. It will really help new people get into Maven. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]