Contributing to Django¶
Django is a community that lives on its volunteers. As it keeps growing, wealways need more people to help others. As soon as you learn Django, you cancontribute in many ways:
- Join thedjango-users mailing list and answer questions. Thismailing list has a huge audience, and we really want to maintain afriendly and helpful atmosphere. If you’re new to the Django community,you should read theposting guidelines.
- Join the#django IRC channel on Freenode 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!
If you think workingwith Django is fun, wait until you start workingonit. We’re passionate about helping Django users make the jump to contributingmembers of the community, so there are several ways you can help Django’sdevelopment:
- Report bugs in ourticket tracker.
- Join thedjango-developers mailing list and share your ideas for howto improve Django. We’re always open to suggestions. You can also interacton the#django-dev IRC channel.
- Submit patches for new and/orfixed behavior. If you’re looking for an easy way to start contributingto Django read theWriting your first patch for Django tutorial and have a look at theeasy pickings tickets. ThePatch review checklist will also behelpful.
- Improve the documentation orwrite unit tests.
- Triage tickets and review patches created byother users.
Really,ANYONE can do something to help make Django better and greater!
Browse the following sections to find out how:
- Advice for new contributors
- Reporting bugs and requesting features
- Triaging tickets
- Writing code
- Writing documentation
- Getting the raw documentation
- Getting started with Sphinx
- How the documentation is organized
- Writing style
- Commonly used terms
- Django-specific terminology
- Guidelines for reStructuredText files
- Django-specific markup
- Documenting new features
- Minimizing images
- An example
- Spelling check
- Translating documentation
django-adminman page
- Localizing Django
- Committing code
