Permalink
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
112 lines (84 sloc) 4.53 KB
-----
Getting Help
-----
Dennis Lundberg
Karl Heinz Marbaise
-----
2007-07-24
2015-06-17
-----
~~ 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.
~~ NOTE: For help with the syntax of this file, see:
~~ https://maven.apache.org/doxia/references/apt-format.html
Getting Help
So something didn't work as you expected it to? You think that
<Maven is broken>. What should you do?
Here's a list of actions that you can take:
*You did check the documentation, didn't you?
Apart from the central Maven site, each of our plugins has a website. Go
to the {{{../plugins/index.html}plugins page}} and follow the link to the
plugin you are having problems with.
* Try the latest version of Maven or the plugin in question
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 {{{../download.html}Maven's download section}}
and the {{{../plugins/index.html}plugin index}}.
*Search the user-list archives
Someone else might have experienced the same problem as you before. A list
of mail-archives can be found on
{{{https://maven.apache.org/mailing-lists.html}mailing list index page}}. Please search one of
them before going any further.
*Ask on the user list
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 {{{https://maven.apache.org/mailing-lists.html}users-list}} and describe your
problem there. Don't expect to get an answer right away. Sometimes it takes a
couple of days.
*Submit an issue
If it turns out that there is indeed something wrong with Maven or one of
the plugins, you should report it to our issue management system JIRA.
First of all you need to create an account in JIRA. This is so that we can
communicate with you while we work together on the issue. Go to the
{{{https://issues.apache.org/jira/secure/Dashboard.jspa}sign up link}} to create an
account if you don't already have one.
**Where?
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 section in JIRA, so using the
correct link is important. Click on <Project Information> and then
<Issue Management>. On that page you will find the correct link.
If the problem is in Maven itself you can find the appropriate link on the
{{{https://maven.apache.org/issue-management.html}issue management}} page.
**How?
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.
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.
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.
What we like best are patches that fixes the problem. If you want to create a
patch for an issue please read the
{{{../guides/development/guide-maven-development.html}Maven Developer Guide}} first.
* References
* {{{http://www.catb.org/~esr/faqs/smart-questions.html}How To Ask Questions The Smart Way}}
* {{{http://opensourcestrategies.blogspot.com/2005/09/how-to-get-support-from-open-source.html}How to Get Support from Open Source Mailing Lists}}