1. ======================

  2. Contributing to Django

  3. ======================

  4. 

  5. Django is a community that lives on its volunteers. As it keeps growing, we

  6. always need more people to help others. You can contribute in many ways, either

  7. on the framework itself or in the wider ecosystem.

  8. 

  9. Work on the Django framework

  10. ============================

  11. 

  12. The work on Django itself falls into three major areas:

  13. 

  14. **Writing code** 💻

  15.     Fix a bug, or add a new feature. You can make a pull request and see **your

  16.     code** in the next version of Django!

  17. 

  18.     Start from the :doc:`writing-code/index` docs.

  19. 

  20. **Writing documentation** ✍️

  21.     Django's documentation is one of its key strengths. It's informative

  22.     and thorough. You can help to improve the documentation and keep it

  23.     relevant as the framework evolves.

  24. 

  25.     See :doc:`writing-documentation` for more.

  26. 

  27. **Localizing Django** 🗺️

  28.     Django is translated into over 100 languages - There's even some

  29.     translation for Klingon?! The i18n team is always looking for translators

  30.     to help maintain and increase language reach.

  31. 

  32.     See :doc:`localizing` to help translate Django.

  33. 

  34. If you think working *with* Django is fun, wait until you start working *on*

  35. it. Really, **ANYONE** can do something to help make Django better and greater!

  36. 

  37. This contributing guide contains everything you need to know to help build the

  38. Django web framework. Browse the following sections to find out how:

  39. 

  40. .. toctree::

  41.    :maxdepth: 2

  42. 

  43.    new-contributors

  44.    bugs-and-features

  45.    triaging-tickets

  46.    writing-code/index

  47.    writing-documentation

  48.    localizing

  49.    committing-code

  50. 

  51. Join the Django community ❤️

  52. ============================

  53. 

  54. We're passionate about helping Django users make the jump to contributing

  55. members of the community. There are several other ways you can help the

  56. Django community and others to maintain a great ecosystem to work in:

  57. 

  58. * Join the `Django forum`_. This forum is a place for discussing the Django

  59.   framework and applications and projects that use it. This is also a good

  60.   place to ask and answer any questions related to installing, using, or

  61.   contributing to Django.

  62. 

  63. * Join the |django-users| mailing list and answer questions. This

  64.   mailing list has a huge audience, and we really want to maintain a

  65.   friendly and helpful atmosphere. If you're new to the Django community,

  66.   you should read the `posting guidelines`_.

  67. 

  68. * Join the `#django IRC channel`_ on Libera.Chat and answer questions. By

  69.   explaining Django to other users, you're going to learn a lot about the

  70.   framework yourself.

  71. 

  72. * Blog about Django. We syndicate all the Django blogs we know about on

  73.   the `community page`_; if you'd like to see your blog on that page you

  74.   can `register it here`_.

  75. 

  76. * Contribute to open-source Django projects, write some documentation, or

  77.   release your own code as an open-source pluggable application. The

  78.   ecosystem of pluggable applications is a big strength of Django, help us

  79.   build it!

  80. 

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

  82. 

  83. .. _posting guidelines: https://code.djangoproject.com/wiki/UsingTheMailingList

  84. .. _#django IRC channel: https://web.libera.chat/#django

  85. .. _community page: https://www.djangoproject.com/community/

  86. .. _Django forum: https://forum.djangoproject.com/

  87. .. _register it here: https://www.djangoproject.com/community/add/blogs/
About Sign Up Leave Feedback Contact