Contributing to Django

The work on Django itself falls into three major areas:

Writing code 💻

Fix a bug, or add a new feature. You can make a pull request and see your code in the next version of Django!

Start from the Writing code docs.

Django’s documentation is one of its key strengths. It’s informative and thorough. You can help to improve the documentation and keep it relevant as the framework evolves.

See for more.

Localizing Django 🗺️

Django is translated into over 100 languages - There’s even some translation for Klingon?! The i18n team is always looking for translators to help maintain and increase language reach.

If you think working with Django is fun, wait until you start working on it. Really, ANYONE can do something to help make Django better and greater!

This contributing guide contains everything you need to know to help build the Django web framework. Browse the following sections to find out how:

• Advice for new contributors
  • Guidelines
• • Reporting bugs
  • Requesting features
• Triaging tickets
  • Triage stages
  • Closing Tickets
• Writing code
  • Unit tests
  • Working with Git and GitHub
• Writing documentation
  • Getting started with Sphinx
  • Writing style
  • Django-specific terminology
  • Django-specific markup
  • An example
  • Link check
  • django-admin man page
• • Translations
  • Documentation
• • Handling pull requests
  • Reverting commits

Join the Django community ❤️

We’re passionate about helping Django users make the jump to contributing members of the community. There are several other ways you can help the Django community and others to maintain a great ecosystem to work in:

• Join the Django forum. This forum is a place for discussing the Django framework and applications and projects that use it. This is also a good place to ask and answer any questions related to installing, using, or contributing to Django.
• Join the mailing list and answer questions. This mailing list has a huge audience, and we really want to maintain a friendly and helpful atmosphere. If you’re new to the Django community, you should read the posting guidelines.
• Join the on Libera.Chat and answer questions. By explaining Django to other users, you’re going to learn a lot about the framework yourself.
• Contribute to open-source Django projects, write some documentation, or release your own code as an open-source pluggable application. The ecosystem of pluggable applications is a big strength of Django, help us build it!

We’re looking forward to working with you. Welcome aboard! ⛵️