| <?xml version="1.0" encoding="UTF-8"?> |
| <!-- |
| 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. |
| |
| --> |
| <document xmlns="http://maven.apache.org/XDOC/2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
| xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd"> |
| |
| <properties> |
| <title>How to contribute?</title> |
| <author email="dev@syncope.apache.org">Apache Syncope Documentation Team</author> |
| </properties> |
| |
| <body> |
| |
| <section name="How to contribute?"> |
| <p> |
| The Apache Syncope™ project is actively seeking new contributors to work on all aspects of the project. |
| We need and appreciate all contributions, including documentation help, source code development and feedback. |
| </p> |
| |
| <subsection name="Code"> |
| <ul> |
| <li>If you have found an issue or you want to propose a new feature, post a message to the |
| <a href="mail-lists.html">Syncope User's list</a> to discuss it. |
| </li> |
| <li>Search existing |
| <a href="https://issues.apache.org/jira/secure/IssueNavigator.jspa" rel="nofollow">issues</a> to see |
| whether someone had already encountered the same issue. |
| </li> |
| <li>If this issue was never encountered before, create a new |
| <a href="http://issues.apache.org/jira/browse/SYNCOPE">JIRA</a> issue. |
| </li> |
| <li>Develop / describe a test case to demonstrate the issue.</li> |
| <li>Attach the new test to the JIRA issue.</li> |
| <li>If you have also developed a fix for the raised issue, attach a patch to it. Here are some useful |
| <a href="https://commons.apache.org/patches.html">guidelines</a> about how to correctly generate a patch. |
| </li> |
| </ul> |
| </subsection> |
| |
| <subsection name="Documentation"> |
| <p>The website is managed via the |
| <a href="http://maven.apache.org/plugins/maven-site-plugin/">maven-site-plugin</a>, hence contributing site |
| content is similar to contributing source code: Create a new issue on JIRA and attach an SVN patch to it. |
| </p> |
| <p>The project |
| <a href="http://cwiki.apache.org/confluence/display/SYNCOPE">Wiki</a> is also available to gather any other |
| kind of documentation or contribution you would like to contribute, and does not require any SVN, Maven or |
| other technical skills. |
| </p> |
| </subsection> |
| |
| <subsection name="Quick references"> |
| <ul> |
| <li> |
| Discussion occurs on the |
| <a href="mail-lists.html">mailing lists</a> |
| </li> |
| <li> |
| Information on accessing the project source code is |
| <a href="source-repository.html">here</a>. |
| </li> |
| <li> |
| Bugs and other issues can be posted on |
| <a href="https://issues.apache.org/jira/browse/SYNCOPE">JIRA</a> |
| </li> |
| </ul> |
| </subsection> |
| </section> |
| |
| <section name="How do I become a contributor or a committer?"> |
| <p>Everyone can contribute to Syncope as a contributor; contributors who build up a history of successful |
| contributions over time are invited to become committers. The difference is that committers have direct write |
| access to the project SVN repositories, while contributors post their contributions to JIRA issues where they're |
| first reviewed, and then committed by a committer to the project's SVN repository. See |
| <a href="http://www.apache.org/dev/contributors.html">http://www.apache.org/dev/contributors.html</a> for a good |
| overview of working as a contributor. |
| </p> |
| <p>We ask contributors of significant amounts of code to fill out and send into Apache, an |
| <a href="http://www.apache.org/licenses/#clas">Individual Contributors License Agreement (ICLA)</a> |
| (and perhaps also a |
| <a href="http://www.apache.org/licenses/#clas">Corporate Contributors License Agreement (CCLA)</a>). |
| </p> |
| <p>If you're interested in committing to the project, you need to establish a history over time of successful |
| contributions to the project. After that, you may be invited to become a committer. |
| </p> |
| <ul> |
| <li> |
| You'll need to fill out some legal paperwork and go through a process to get an Apache committer account: See |
| <a rel="nofollow" href="http://apache.org/dev/new-committers-guide.html"> New Committers Guide</a>, |
| <a rel="nofollow" href="http://apache.org/dev/contributors.html"> Contributors</a>, and |
| <a rel="nofollow" href="http://apache.org/dev/committers.html"> Committers</a> for more details. |
| </li> |
| <li> |
| After you've received an email from |
| <a href="mailto:root@apache.org">root@apache.org</a> with your committer account information, change your |
| initial password using the |
| <a href="https://id.apache.org">Apache Account Utility</a>. For more details see |
| <a rel="nofollow" href="http://apache.org/dev/version-control.html">Committer Subversion Access</a>. |
| </li> |
| <li> |
| Test your SVN account by checking out the Syncope sources: |
| <a href="http://svn.apache.org/viewvc/syncope/">Subversion Repository</a>. |
| </li> |
| </ul> |
| <p>All Committers and Contributors should:</p> |
| <ul> |
| <li>Sign up for a |
| <a rel="nofollow" href="https://cwiki.apache.org/confluence/signup.action">Wiki</a> account. |
| </li> |
| <li>Sign up for an |
| <a rel="nofollow" href="http://issues.apache.org/jira/">ASF JIRA</a> account. |
| </li> |
| </ul> |
| </section> |
| </body> |
| </document> |