How to contribute?
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.
Looking for ideas?
Code
- If you have found an issue or you want to propose a new feature, post a message to the Syncope Dev list or jump on IRC to discuss it.
- Search existing issues to see whether someone had already encountered the same issue.
- If this issue was never encountered before, create a new JIRA issue.
- Get the source code
- Develop / describe a test case to demonstrate the issue.
- Review and apply our Git workflow.
Documentation
The website is managed via the maven-site-plugin and the guides are being maintained with Asciidoctor, hence contributing site content or guides is similar to contributing source code.
The project Wiki is also available to gather any other kind of documentation or contribution you would like to contribute, and does not require any GIT, Maven or other technical skills.
How do I become a contributor or a committer?
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 GIT repositories, while contributors post their contributions to JIRA issues where they're first reviewed, and then committed by a committer to the project's GIT repository. See https://www.apache.org/dev/contributors.html for a good overview of working as a contributor.
We ask contributors of significant amounts of code to fill out and send into Apache, an Individual Contributors License Agreement (ICLA) (and perhaps also a Corporate Contributors License Agreement (CCLA)).
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.
- You'll need to fill out some legal paperwork and go through a process to get an Apache committer account: See New Committers Guide, Contributors, and Committers for more details.
- After you've received an email from root@apache.org with your committer account information, change your initial password using the Apache Account Utility. For more details see Committer GIT Access.
All Committers and Contributors should: