CONTRIBUTING

First, thank you very much, that you would like to contribute to django CMS. We always welcome contributions, like many other open-source projects. We are very thankful to the many present, past and future contributors, to our community heroes and to the members of the django CMS Association.

Code of Conduct

django CMS is governed by a Code of Conduct. All participants in our community and its various forums are expected to abide by it.

Issues

• Please report any bugs through GitHub issues.
• For security issues please see further below.

Contributing Code

Here’s what the pull request process looks like in brief:

1. Fork our GitHub repository, https://github.com/django-cms/django-cms
2. Work locally and push your changes to your repository.
3. When you feel your code is good enough for inclusion, send us a pull request.
4. After that, please join the Slack Channel of our Pull Request Review work group (#workgroup-pr-review). This group of friendly community members is dedicated to reviewing pull requests. Report your PR and find a “pr review buddy” who is going to review your pull request.
5. Get acknowledged by the django CMS community for your contribution :-)

To learn more about basic requirements and standards of code contribution, please familiarize yourself with our comprehensive documentation.

django CMS commits follow the Conventional Commits Guideline, please try to follow the Guidelines in your commit messages to ease our review & merge process.

Proposing large feature additions

In terms of proposing large feature additions, we follow the best practice of DEPS.

To create a proposal...

1. please use this DEP template
2. create a discussion in the main django CMS repository
3. join the Tech Committee Slack Channel (#technical-committee) and ask for a RFC.
4. After RFC is completed, add the proposal to the agenda of the TC for approval.

Contribution documentation

We maintain comprehensive contribution documentation. Please familiarise yourself with it before submitting any issues or pull requests.

Security issues

Please have a look at our security policy for how to deal with security issues.

If you think you have discovered a security issue in our code, please do not raise it in any public forum until we have had a chance to deal with it.

Community & Association

You can join us online:

• in our django CMS Slack channel
• on our Discourse forum

You can join a work group and work collaboratively on django CMS

• work groups

You can also follow:

• the @djangocms Twitter account for general announcements

You can become a member of the django CMS Association and receive benefits

• Membership

Receive rewards for submitting pull requests

Sign up for our Bounty program.

Join a work group

As part of the django CMS Association we have formed several work groups to work together on different django CMS development topics. If you want to become part of contributor team, feel free to join one of our groups. You will meet friendly people and improve your programming skills and make a real difference in the django CMS open source project.