content/xdoc/index.xml.vm

<?xml version="1.0"?>
<!--

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

  https://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.

-->
<document>
  <properties>
    <title>Welcome to Apache Maven</title>
    <author email="brett@apache.org">Brett Porter</author>
    <author email="jason@takari.io">Jason van Zyl</author>
    <author email="olamy@apache.org">Olivier Lamy</author>
  </properties>
  <body>

    <section name="Welcome to Apache Maven">
      <p>
        Apache Maven is a build tool for Java projects. Using a project object model
        (POM), Maven manages a project's compilation, testing, and documentation.
      </p>
      <p>
        You can find more information in the "About Maven"
        section of the sidebar. This includes an in-depth description of <a href="what-is-maven.html">what Maven is</a> and a list of some of its main features.
      </p>
      <p>
        <!-- TODO: this could be the big button type thing instead of a list of links -->
        This site is separated into the following sections:
      </p>
      <!-- TODO: use CSS -->
      <table>
      <tr>
        <th style="white-space:nowrap; font-weight: bold; font-size: 1.75em" rowspan="3">Use</th>
        <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
          <a href="download.html">Download</a>, <a href="install.html">Install</a>, <a href="configure.html">Configure</a>, <a href="run.html">Run</a> Maven
        </th>
        <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em">
           <a href="plugins/index.html">Maven Plugins</a> and <a href="extensions/index.html">Maven Extensions</a>
        </th>
      </tr>
      <tr>
        <td>Information for those needing to build a project that uses Maven</td>
        <td>
            Lists of plugins and extensions to help with your builds.
        </td>
      </tr>
      <tr>
        <td><b>Maven 4</b>: Learn <a href="whatsnewinmaven4.html">what's new</a> and <a href="/guides/mini/guide-migration-to-mvn4.html">how to migrate a project</a> to Maven 4.</td>
        <td>
          Upcoming: How to migrate plugins to the new Maven 4 API?
        </td>
      </tr>
      <tr>
        <th style="white-space:nowrap; font-weight: bold; font-size: 1.75em" rowspan="2">Extend</th>
        <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="plugin-developers/index.html">Write Maven Plugins</a></th>
        <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="repository/index.html">Improve the Maven Central Repository</a></th>
      </tr>
      <tr>
        <td>
            Information for developers writing Maven plugins.
        </td>
        <td>
            Information for those who may or may not use Maven, but are interested in getting project metadata into the
            <a href="repository/index.html">central repository</a>.
        </td>
      </tr>
      <tr>
        <th style="white-space:nowrap; font-weight: bold; font-size: 1.75em" rowspan="2">Contribute</th>
        <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="guides/development/guide-helping.html">Help Maven</a></th>
        <th style="white-space:nowrap; font-weight: bold; font-size: 1.25em"><a href="developers/index.html">Develop Maven</a></th>
      </tr>
      <tr>
        <td>
            Information if you'd like to get involved. Maven is an open source community and welcomes contributions.
        </td>
        <td>
            Information for those who are currently Maven developers, or who are interested
            in contributing to the Maven project itself.
        </td>
      </tr>
      </table>
      <p>
        Each guide is divided into a number of trails to get you started on a particular topic, and includes a
        reference area and a "cookbook" of common examples.
      </p>
      <p>
        You can access the guides at any time from the left navigation.
        If you are looking for a quick reference, you can use the <a href="guides/index.html">documentation index</a>.
      </p>

      <h3>How to Get Support</h3>
      <p>
        Support for Maven is available in a variety of different forms.
      </p>
      <p>
        To get started, search the documentation,
        <a href="issue-management.html">issue management system</a>, the <a href="https://cwiki.apache.org/confluence/display/MAVEN">wiki</a>,
        or the <a href="mailing-lists.html">mailing list archives</a> to
        see if the problem has been solved or reported before.
      </p>
      <p>
        If the problem has not been reported before, the recommended way to get help is to
        subscribe to the <a href="mailing-lists.html">Maven Users Mailing list</a>. Many other users and Maven developers
        will answer your questions there, and the answer will be archived for others in the future.
      </p>
      <p>
        You can also reach the Maven developers on <a href="community.html">Slack</a>.
      </p>

      <h3>Apache Software Foundation</h3>
      <p>
        Maven is a part of the Apache Software Foundation. We'd like to <a href="https://www.apache.org/foundation/thanks.html">thank
        the sponsors</a> that provide financial assistance to the foundation. For more information on how you can support the
        foundation, see the <a href="https://www.apache.org/foundation/sponsorship.html">sponsorship</a> page.
      </p>
      <p>
        <a href="https://www.apache.org/events/current-event.html">
          <img src="https://www.apache.org/events/current-event-234x60.png" alt="Apache Events" style="float: left"/>
        </a>
        You can also attend <a href="https://www.apache.org/events/current-event.html">Apache Events</a>. Ask on the <a href="mailing-lists.html">Maven User mailing list</a>
        if Maven team members will be there. It can be a great opportunity to meet them.
      </p>
    </section>
  </body>
</document>