======================
Contributing to Django
======================

Django is a community that lives on its volunteers. As it keeps growing, we
always need more people to help others. As soon as you learn Django, you can
contribute in many ways:

    * Join the `django-users`_ 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 `#django IRC channel`_ on Freenode and answer questions. By
      explaining Django to other users, you're going to learn a lot about the
      framework yourself.

    * Blog about Django. We syndicate all the Django blogs we know about on
      the `community page`_; if you'd like to see your blog on that page you
      can `register it here`_.

    * 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!

If you think working *with* Django is fun, wait until you start working *on*
it. We're passionate about helping Django users make the jump to contributing
members of the community, so there are several ways you can help Django's
development:

    * :doc:`Report bugs <bugs-and-features>` in our `ticket tracker`_.

    * Join the `django-developers`_ mailing list and share your ideas for how
      to improve Django. We're always open to suggestions.

    * :doc:`Submit patches <writing-code/submitting-patches>` for new and/or
      fixed behavior. If you're looking for an easy way to start contributing
      to Django have a look at the `easy pickings`_ tickets.

    * :doc:`Improve the documentation <writing-documentation>` or
      :doc:`write unit tests <writing-code/unit-tests>`.

    * :doc:`Triage tickets and review patches <triaging-tickets>` created by
      other users.

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

Browse the following sections to find out how:

.. toctree::
   :maxdepth: 2

   new-contributors
   bugs-and-features
   triaging-tickets
   writing-code/index
   writing-documentation
   translations
   committing-code

.. _django-users: http://groups.google.com/group/django-users
.. _posting guidelines: https://code.djangoproject.com/wiki/UsingTheMailingList
.. _#django IRC channel: irc://irc.freenode.net/django
.. _community page: http://www.djangoproject.com/community/
.. _register it here: http://www.djangoproject.com/community/add/blogs/
.. _django-developers: http://groups.google.com/group/django-developers
.. _ticket tracker: http://code.djangoproject.com/newticket
.. _easy pickings: http://code.djangoproject.com/query?status=!closed&easy=1
