Modified: maven/website/content/users/getting-help.html ============================================================================== --- maven/website/content/users/getting-help.html (original) +++ maven/website/content/users/getting-help.html Wed Jul 2 13:31:04 2025 @@ -2,7 +2,7 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/users/getting-help.apt at 2025-07-02 + | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/markdown/users/getting-help.md at 2025-07-02 | Rendered using Apache Maven Fluido Skin 2.1.0 --> <html xmlns="http://www.w3.org/1999/xhtml"; lang="en"> @@ -10,10 +10,6 @@ <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0" /> - <meta name="author" content="Dennis Lundberg" /> - <meta name="author" content="Karl Heinz Marbaise" /> - <meta name="date" content="2007-07-24 -2015-06-17" /> <title>Getting Help â Maven</title> <link rel="stylesheet" href="../css/apache-maven-fluido-2.1.0.min.css" /> <link rel="stylesheet" href="../css/site.css" /> @@ -49,7 +45,7 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/";>Apache</a><span class="divider">/</span></li> <li><a href="../index.html">Maven</a><span class="divider">/</span></li> - <li class="active">Getting Help <a href="https://github.com/apache/maven-site/tree/master/content/apt/users/getting-help.apt";><img src="../images/accessories-text-editor.png" alt="Edit" /></a></li> + <li class="active">Getting Help <a href="https://github.com/apache/maven-site/tree/master/content/markdown/users/getting-help.md";><img src="../images/accessories-text-editor.png" alt="Edit" /></a></li> <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2025-07-02</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html">Get Sources</a></li> @@ -65,7 +61,6 @@ <li><a href="https://www.apache.org/licenses/";>License</a></li> <li class="nav-header">About Maven</li> <li><a href="../what-is-maven.html">What is Maven?</a></li> - <li><a href="../maven-features.html">Features</a></li> <li><a href="../install.html">Installation</a></li> <li><a href="../download.html">Downloads</a></li> <li><a href="../users/index.html"><span class="icon-chevron-right"></span>Use</a></li> @@ -155,34 +150,78 @@ </div> </header> <main id="bodyColumn" class="span10"> +<!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +--> <section><a id="Getting_Help"></a> <h1>Getting Help</h1> -<p>So something didn't work as you expected it to? You think that <i>Maven is broken</i>. What should you do?</p> +<p>So something didn't work as you expected it to? +You think that <em>Maven is broken</em>. +What should you do?</p> <p>Here's a list of actions that you can take:</p><section><a id="You_did_check_the_documentation.2C_didn.27t_you.3F"></a> <h2>You did check the documentation, didn't you?</h2> -<p>Apart from the central Maven site, each of our plugins has a website. Go to the <a href="../plugins/index.html">plugins page</a> and follow the link to the plugin you are having problems with.</p></section><section><a id="Try_the_latest_version_of_Maven_or_the_plugin_in_question"></a> +<p>Apart from the central Maven site, each of our plugins has a website. +Go to the <a href="../plugins/index.html">plugins page</a> and follow the link to the plugin you are having problems with.</p></section><section><a id="Try_the_latest_version_of_Maven_or_the_plugin_in_question"></a> <h2>Try the latest version of Maven or the plugin in question</h2> -<p>Before you start intensive investigations on your problem, you should try to update Maven and/or the plugins in question to the latest stable release. After all, the issue you encounter might have been fixed already. To find out what is the latest stable release version, consult <a href="../download.html">Maven's download section</a> and the <a href="../plugins/index.html">plugin index</a>.</p></section><section><a id="Search_the_user-list_archives"></a> +<p>Before you start intensive investigations on your problem, you should try to update Maven and/or the plugins +in question to the latest stable release. +After all, the issue you encounter might have been fixed already. +To find out what is the latest stable release version, consult <a href="../download.html">Maven's download section</a> +and the <a href="../plugins/index.html">plugins page</a>.</p></section><section><a id="Search_the_user-list_archives"></a> <h2>Search the user-list archives</h2> -<p>Someone else might have experienced the same problem as you before. A list of mail-archives can be found on <a class="externalLink" href="https://maven.apache.org/mailing-lists.html";>mailing list index page</a>. Please search one of them before going any further.</p></section><section><a id="Ask_on_the_user_list"></a> +<p>Someone else might have experienced the same problem as you before. +A list of mail-archives can be found on <a href="https://maven.apache.org/mailing-lists.html"; class="externalLink">mailing list index page</a>. +Please search one of them before going any further.</p></section><section><a id="Ask_on_the_user_list"></a> <h2>Ask on the user list</h2> -<p>Our community is very helpful, just ask it the right way. See the references section, at the end of this page, for info on how to do that. Subscribe to the <a class="externalLink" href="https://maven.apache.org/mailing-lists.html";>users-list</a> and describe your problem there. Don't expect to get an answer right away. Sometimes it takes a couple of days.</p></section><section><a id="Submit_an_issue"></a> +<p>Our community is very helpful, just ask it the right way. +See the references section, at the end of this page, for info on how to do that. +Subscribe to the <a href="https://maven.apache.org/mailing-lists.html"; class="externalLink">users list</a> and describe your problem there. +Don't expect to get an answer right away. +Sometimes it takes a couple of days.</p></section><section><a id="Submit_an_issue"></a> <h2>Submit an issue</h2> -<p>If it turns out that there is indeed something wrong with Maven or one of the plugins, you should report it to the issue management system. All projects (Apache Maven core, Apache Maven plugins, sub components) have been migrated to use GitHub issues.</p> -<p>You don't need create an issue only to ask us something - in such case please first ask on <a class="externalLink" href="https://maven.apache.org/mailing-lists.html";>users-list</a></p><section><a id="Where.3F"></a> -<h3>Where?</h3> -<p>If the problem is in one of the plugins, check the site of that plugin to get the correct link. Each plugin has its own GitHub repository, so using the correct link is important. Click on <i>Project Information</i> and then <i>Source Code Management</i>. On that page you will find the correct link.</p> -<p>If the problem is in Maven itself you can find the appropriate link to GitHub repository on the <a class="externalLink" href="https://maven.apache.org/scm.html";>scm</a> page.</p></section><section><a id="How.3F"></a> -<h3>How?</h3> -<p>Just describing the problem is not enough. It takes a developer a lot of time to make a usable POM to even attempt to assess the problem. Issues that states problems without something usable to try out will be closed as incomplete.</p> -<p>Please attach a working POM, or a set of POMs, that we can download and run. We appreciate reports, but if you don't have something usable for us it's incredibly hard for us to manage the issues. A POM goes a long way to helping us resolve problems. </p> -<p>Create a POM that can be used to verify that it is a bug. If your pom uses plugins, make sure that you have specified the version for each and every plugin. If you don't, then we might not be using the same version as you are when we test it.</p> -<p>What we like best are patches that fixes the problem. If you want to create a patch for an issue please read the <a href="../guides/development/guide-maven-development.html">Maven Developer Guide</a> first.</p> -<p>If you have been able to figure out the changes needed for your problem or enhancement request, you can directly create a Pull Request against the GitHub repository.</p></section></section><section><a id="References"></a> +<p>If it turns out that there is indeed something wrong with Maven or one of the plugins, you should report it to the issue management system. +All projects (Apache Maven core, Apache Maven plugins, subcomponents) have been migrated to use GitHub issues.</p> +<p>You don't need to create an issue only to ask us something - in such case please first ask on <a href="https://maven.apache.org/mailing-lists.html"; class="externalLink">users list</a>.</p></section><section><a id="Where.3F"></a> +<h2>Where?</h2> +<p>If the problem is in one of the plugins, check the site of that plugin to get the correct link. +Each plugin has its own GitHub repository, so using the correct link is important. +Click on <em>Project Information</em> and then <em>Source Code Management</em>. +On that page you will find the correct link.</p> +<p>If the problem is in Maven itself you can find the appropriate link to GitHub repository on the <a href="/scm.html">scm</a> page.</p></section><section><a id="How.3F"></a> +<h2>How?</h2> +<p>Just describing the problem is not enough. +It takes a developer a lot of time to make a usable POM to even attempt to assess the problem. +Issues that states problems without something usable to try out will be closed as incomplete.</p> +<p>Please attach a working POM, or a set of POMs, that we can download and run. +We appreciate reports, but if you don't have something usable for us, it's incredibly hard for us to manage the issues. +A POM goes a long way to helping us resolve problems.</p> +<p>Create a POM that can be used to verify that it is a bug. +If your pom uses plugins, make sure that you have specified the version for each and every plugin. +If you don't, then we might not be using the same version as you are when we test it.</p> +<p>What we like best are patches that fixes the problem. +If you want to create a patch for an issue please read the <a href="../guides/development/guide-maven-development.html">Maven Developer Guide</a> first.</p> +<p>If you have been able to figure out the changes needed for your problem or enhancement request, you can directly create a Pull Request against the GitHub repository.</p></section><section><a id="References"></a> <h2>References</h2> <ul> -<li><a class="externalLink" href="http://www.catb.org/~esr/faqs/smart-questions.html";>How To Ask Questions The Smart Way</a> (Note: HTTP only!)</li> -<li><a class="externalLink" href="http://opensourcestrategies.blogspot.com/2005/09/how-to-get-support-from-open-source.html";>How to Get Support from Open Source Mailing Lists</a></li></ul></section></section> </main> + +<li><a href="http://www.catb.org/~esr/faqs/smart-questions.html"; class="externalLink">Eric Steven Raymond - How To Ask Questions The Smart Way</a> (Note: HTTP only!)</li> +<li><a href="http://opensourcestrategies.blogspot.com/2005/09/how-to-get-support-from-open-source.html"; class="externalLink">Blog: Open Source Strategies - How to Get Support from Open Source Mailing Lists</a> (Note: HTTP only!)</li> +</ul></section></section> </main> </div> </div> <hr/>
Modified: maven/website/content/users/index.html ============================================================================== --- maven/website/content/users/index.html (original) +++ maven/website/content/users/index.html Wed Jul 2 13:31:04 2025 @@ -2,7 +2,7 @@ <!-- - | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/apt/users/index.apt at 2025-07-02 + | Generated by Apache Maven Doxia Site Renderer 2.0.0 from content/markdown/users/index.md at 2025-07-02 | Rendered using Apache Maven Fluido Skin 2.1.0 --> <html xmlns="http://www.w3.org/1999/xhtml"; lang="en"> @@ -10,9 +10,7 @@ <meta charset="UTF-8" /> <meta name="viewport" content="width=device-width, initial-scale=1" /> <meta name="generator" content="Apache Maven Doxia Site Renderer 2.0.0" /> - <meta name="author" content="Brett Porter" /> - <meta name="date" content="2006-11-03" /> - <title>Users Centre â Maven</title> + <title>Maven Users Centre â Maven</title> <link rel="stylesheet" href="../css/apache-maven-fluido-2.1.0.min.css" /> <link rel="stylesheet" href="../css/site.css" /> <link rel="stylesheet" href="../css/print.css" media="print" /> @@ -47,7 +45,7 @@ <ul class="breadcrumb"> <li><a href="https://www.apache.org/";>Apache</a><span class="divider">/</span></li> <li><a href="../index.html">Maven</a><span class="divider">/</span></li> - <li class="active">Users Centre <a href="https://github.com/apache/maven-site/tree/master/content/apt/users/index.apt";><img src="../images/accessories-text-editor.png" alt="Edit" /></a></li> + <li class="active">Maven Users Centre <a href="https://github.com/apache/maven-site/tree/master/content/markdown/users/index.md";><img src="../images/accessories-text-editor.png" alt="Edit" /></a></li> <li id="publishDate" class="pull-right"><span class="divider">|</span> Last Published: 2025-07-02</li> <li class="pull-right"><span class="divider">|</span> <a href="../scm.html">Get Sources</a></li> @@ -63,7 +61,6 @@ <li><a href="https://www.apache.org/licenses/";>License</a></li> <li class="nav-header">About Maven</li> <li><a href="../what-is-maven.html">What is Maven?</a></li> - <li><a href="../maven-features.html">Features</a></li> <li><a href="../install.html">Installation</a></li> <li><a href="../download.html">Downloads</a></li> <li class="active"><a><span class="icon-chevron-down"></span>Use</a> @@ -157,22 +154,46 @@ </div> </header> <main id="bodyColumn" class="span10"> +<!-- +Licensed to the Apache Software Foundation (ASF) under one +or more contributor license agreements. See the NOTICE file +distributed with this work for additional information +regarding copyright ownership. The ASF licenses this file +to you under the Apache License, Version 2.0 (the +"License"); you may not use this file except in compliance +with the License. You may obtain a copy of the License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, +software distributed under the License is distributed on an +"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY +KIND, either express or implied. See the License for the +specific language governing permissions and limitations +under the License. +--> <section><a id="Maven_Users_Centre"></a> <h1>Maven Users Centre</h1> <p>This documentation centre is for those that have decided to use Maven to build their project, and would like to get started quickly, or are already using Maven and would like to add new functionality or fix a problem in their build.</p> <ul> -<li><a href="../download.html"> Download Maven</a> - Download the latest version of Maven</li> -<li><a href="../guides/getting-started/maven-in-five-minutes.html"> The 5 minute test</a> - Learn how to use Maven in 5 minutes</li> -<li><a href="../guides/getting-started/index.html"> Getting Started Tutorial</a> - An in depth tutorial once you've learned the basics</li> -<li><a href="./getting-help.html"> Getting Help</a> - How to get help with Maven</li></ul><section><a id="Maven_4"></a> + +<li><a href="../download.html">Download Maven</a> - Download the latest version of Maven</li> +<li><a href="../guides/getting-started/maven-in-five-minutes.html">Maven in five minutes</a> - Learn how to use Maven in 5 minutes</li> +<li><a href="../guides/getting-started/index.html">Getting Started Tutorial</a> - An in depth tutorial once you've learned the basics</li> +<li><a href="./getting-help.html">Getting Help</a> - How to get help with Maven</li> +</ul><section><a id="Maven_4"></a> <h2>Maven 4</h2> <ul> -<li><a href="/whatsnewinmaven4.html"> What's new in Maven 4?</a> - Compact overview about all changes of Maven 4</li> -<li><a href="../guides/mini/guide-migration-to-mvn4.html"> Migrate to Maven 4</a> - Learn how to migrate projects to Maven 4</li></ul></section><section><a id="Reference"></a> + +<li><a href="/whatsnewinmaven4.html">What's new in Maven 4?</a> - Compact overview about all changes of Maven 4</li> +<li><a href="../guides/mini/guide-migration-to-mvn4.html">Migrate to Maven 4</a> - Learn how to migrate projects to Maven 4</li> +</ul></section><section><a id="Reference"></a> <h2>Reference</h2> <ul> -<li><a href="../pom.html"> POM Reference</a></li> -<li><a href="../settings.html"> Settings Reference</a></li></ul></section></section> </main> + +<li><a href="../pom.html">POM Reference</a></li> +<li><a href="../settings.html">Settings Reference</a></li> +</ul></section></section> </main> </div> </div> <hr/> Modified: maven/website/content/what-is-maven.html ============================================================================== --- maven/website/content/what-is-maven.html (original) +++ maven/website/content/what-is-maven.html Wed Jul 2 13:31:04 2025 @@ -61,7 +61,6 @@ <li><a href="https://www.apache.org/licenses/";>License</a></li> <li class="nav-header">About Maven</li> <li class="active"><a>What is Maven?</a></li> - <li><a href="maven-features.html">Features</a></li> <li><a href="install.html">Installation</a></li> <li><a href="download.html">Downloads</a></li> <li><a href="users/index.html"><span class="icon-chevron-right"></span>Use</a></li> @@ -218,7 +217,33 @@ designed to be flexible to the needs of it cannot cater to every situation without compromising its objectives.</p> <p>If your project has an unusual build structure that cannot be reorganized, you may have to forgo some features or the use of -Maven altogether.</p></section></section><section><a id="What_is_Maven_Not.3F"></a> +Maven altogether.</p></section></section><section><a id="Feature_summary"></a> +<h2>Feature summary</h2> +<p>The following are the key features of Maven in a nutshell:</p> +<ul> + +<li>Simple project setup that follows best practices - get a new project or module started in seconds-</li> +<li>Consistent usage across all projects - means no ramp up time for new developers coming onto a project-</li> +<li>Superior dependency management including automatic updating, dependency closures (also known as transitive dependencies)-</li> +<li>Able to easily work with multiple projects at the same time-</li> +<li>A <a href="/repository/">large and growing repository of libraries and metadata</a> to use out of the box, and arrangements in place with the largest Open Source projects for real-time availability of their latest releases-</li> +<li>Extensible, with the ability to easily <a href="/plugin-developers/">write plugins</a> in Java or scripting languages-</li> +<li>Instant access to new features with little or no extra configuration.</li> +<li>Ant tasks for dependency management and deployment outside of Maven-</li> +<li>Model based builds: +Maven is able to build any number of projects into predefined output types such as a JAR, WAR, or distribution based on metadata about the project, without the need to do any scripting in most cases.</li> +<li>Coherent site of project information: +Using the same metadata as for the build process, Maven is able to generate a website or PDF including any documentation you care to add, and adds to that standard reports about the state of development of the project. +Examples of this information can be seen at the bottom of the left-hand navigation of this site under the “<em>Project Information</em>” and “<em>Project Reports</em>” submenus.</li> +<li>Release management and distribution publication: +Without much additional configuration, Maven will integrate with your source control system (such as Subversion or Git) and manage the release of a project based on a certain tag. +It can also publish this to a distribution location for use by other projects. +Maven is able to publish individual outputs such as a JAR, an archive including other dependencies and documentation, or as a source distribution.</li> +<li>Dependency management: +Maven encourages the use of a central repository of JARs and other dependencies. +Maven comes with a mechanism that your project's clients can use to download any JARs required for building your project from a central JAR repository much like Perl's CPAN. +This allows users of Maven to reuse JARs across projects and encourages communication between projects to ensure that backward compatibility issues are dealt with.</li> +</ul></section><section><a id="What_is_Maven_Not.3F"></a> <h2>What is Maven Not?</h2> <p>You might have heard some of the following things about Maven:</p> <ul> Modified: maven/website/content/whatsnewinmaven4.html ============================================================================== --- maven/website/content/whatsnewinmaven4.html (original) +++ maven/website/content/whatsnewinmaven4.html Wed Jul 2 13:31:04 2025 @@ -62,7 +62,6 @@ <li><a href="https://www.apache.org/licenses/";>License</a></li> <li class="nav-header">About Maven</li> <li><a href="what-is-maven.html">What is Maven?</a></li> - <li><a href="maven-features.html">Features</a></li> <li><a href="install.html">Installation</a></li> <li><a href="download.html">Downloads</a></li> <li><a href="users/index.html"><span class="icon-chevron-right"></span>Use</a></li>
