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.

All Committers and Contributors should:

  • Sign up for a Wiki account.
  • Sign up for an ASF JIRA account.