- Language:en
Contributing to Django¶
Django is a community that lives on its volunteers. As it keeps growing, wealways need more people to help others. You can contribute in many ways, eitheron the framework itself or in the wider ecosystem.
Communication channels¶
We’re passionate about helping Django users make the jump to contributingmembers of the community. Communication is key - working on Django is beingpart of a conversation. Join it, to become familiar with what we’re doing andhow we talk about it. You’ll be able to form relationships with moreexperienced contributors who are there to help guide you towards success.
Join the Django community¶
There are several ways you can help the Django community and others to maintaina great ecosystem to work in:
Join theDjango Forum. This forum is a place for discussing the Djangoframework and applications and projects that use it. This is also a goodplace to ask and answer any questions related to installing, using, orcontributing to Django.
Join theDjango Discord server to discuss and answer questions. Byexplaining Django to other users, you’re going to learn a lot about theframework yourself.
Blog about Django. We syndicate all the Django blogs we know about onthecommunity page; if you’d like to see your blog on that page youcanregister it here.
Contribute to open-source Django projects, write some documentation, orrelease your own code as an open-source pluggable application. Theecosystem of pluggable applications is a big strength of Django, help usbuild it!
Getting started¶
Django encourages and welcomes new contributors, and makes an effort to helpthem become experienced, confident contributors to Open Source Software (OSS).Our documentation contains guidance for first-time contributors, including:
Work on the Django framework¶
If you enjoy workingwith Django, wait until you start workingon it.Really,anyone can do something to improve Django, which will improve theexperience of lots of people!
The work on Django itself falls into three major areas:
Contributing code¶
Fix a bug, or add a new feature. You can make a pull request and seeyourcode in the next version of Django.
Contributing documentation¶
Django’s documentation is one of its key strengths. It’s informative andthorough. You can help to improve the documentation and keep it relevant as theframework evolves.
- Writing documentation
- The Django documentation process
- How the documentation is organized
- How to start contributing documentation
- Writing style
- Commonly used terms
- Django-specific terminology
- Guidelines for reStructuredText files
- Django-specific markup
- Documenting new features
- Minimizing images
- An example
- Translating documentation
django-adminman page
Localizing Django¶
Django is translated into over 100 languages - There’s even some translationfor Klingon?! The i18n team is always looking for translators to help maintainand increase language reach.
Other ways of contributing¶
Explore additional avenues of contributing to Django beyond coding. Django’sticket tracker is the central hub for managing issues, improvements, andcontributions to Django. It’s a valuable resource where you can report bugs youencounter or assist in triaging existing tickets to ensure a smooth developmentworkflow.
Django also has aprocess for suggesting ideaswhere you can join the community in discussing ideas for new features. Beyondthe Django codebase, there’s avibrant ecosystem that is maintained by thecommunity that you can contribute to.
Explore the ways you can make a difference below, and join us in making Djangobetter for everyone.
We’re looking forward to working with you. Welcome aboard!
