Refs #32412 -- Adjusted Contributing Guide start page.
* Added headers emphasising Work on the framework vs Join the community sections, to raise the visibility of the community section. * Added callouts to three main code/docs/translations areas, linking to respective start pages. * Moved some Writing code specific content from the start page to the Writing code index. This clarifies the start page and adds content to the previously empty Writing code index. Co-authored-by: Carlton Gibson <carlton.gibson@noumenal.es>
This commit is contained in:
parent
b23232b6ab
commit
ead9085f08
|
@ -3,8 +3,57 @@ Contributing to Django
|
||||||
======================
|
======================
|
||||||
|
|
||||||
Django is a community that lives on its volunteers. As it keeps growing, we
|
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
|
always need more people to help others. You can contribute in many ways, either
|
||||||
contribute in many ways:
|
on the framework itself or in the wider ecosystem.
|
||||||
|
|
||||||
|
Work on the Django framework
|
||||||
|
============================
|
||||||
|
|
||||||
|
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 :doc:`writing-code/index` docs.
|
||||||
|
|
||||||
|
**Writing documentation** ✍️
|
||||||
|
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 :doc:`writing-documentation` for more.
|
||||||
|
|
||||||
|
**Localizing Django** 🗺️
|
||||||
|
Django is translated into over 100 languages - There's even some
|
||||||
|
translation for Klingon?! The i18n team are always looking for translators
|
||||||
|
to help maintain and increase language reach.
|
||||||
|
|
||||||
|
See :doc:`localizing` to help translate Django.
|
||||||
|
|
||||||
|
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:
|
||||||
|
|
||||||
|
.. toctree::
|
||||||
|
:maxdepth: 2
|
||||||
|
|
||||||
|
new-contributors
|
||||||
|
bugs-and-features
|
||||||
|
triaging-tickets
|
||||||
|
writing-code/index
|
||||||
|
writing-documentation
|
||||||
|
localizing
|
||||||
|
committing-code
|
||||||
|
|
||||||
|
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
|
* 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
|
framework and applications and projects that use it. This is also a good
|
||||||
|
@ -29,49 +78,10 @@ contribute in many ways:
|
||||||
ecosystem of pluggable applications is a big strength of Django, help us
|
ecosystem of pluggable applications is a big strength of Django, help us
|
||||||
build it!
|
build it!
|
||||||
|
|
||||||
If you think working *with* Django is fun, wait until you start working *on*
|
We're looking forward to working with you. Welcome aboard! ⛵️
|
||||||
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. You can also interact
|
|
||||||
on the `#django-dev IRC channel`_.
|
|
||||||
|
|
||||||
* :doc:`Submit patches <writing-code/submitting-patches>` for new and/or
|
|
||||||
fixed behavior. If you're looking for a way to get started contributing
|
|
||||||
to Django read the :doc:`/intro/contributing` tutorial and have a look at the
|
|
||||||
`easy pickings`_ tickets. The :ref:`patch-review-checklist` will also be
|
|
||||||
helpful.
|
|
||||||
|
|
||||||
* :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
|
|
||||||
localizing
|
|
||||||
committing-code
|
|
||||||
|
|
||||||
.. _posting guidelines: https://code.djangoproject.com/wiki/UsingTheMailingList
|
.. _posting guidelines: https://code.djangoproject.com/wiki/UsingTheMailingList
|
||||||
.. _#django IRC channel: https://webchat.freenode.net/#django
|
.. _#django IRC channel: https://webchat.freenode.net/#django
|
||||||
.. _#django-dev IRC channel: https://webchat.freenode.net/#django-dev
|
|
||||||
.. _community page: https://www.djangoproject.com/community/
|
.. _community page: https://www.djangoproject.com/community/
|
||||||
.. _Django forum: https://forum.djangoproject.com/
|
.. _Django forum: https://forum.djangoproject.com/
|
||||||
.. _register it here: https://www.djangoproject.com/community/add/blogs/
|
.. _register it here: https://www.djangoproject.com/community/add/blogs/
|
||||||
.. _ticket tracker: https://code.djangoproject.com/
|
|
||||||
.. _easy pickings: https://code.djangoproject.com/query?status=!closed&easy=1
|
|
||||||
|
|
|
@ -2,9 +2,31 @@
|
||||||
Writing code
|
Writing code
|
||||||
============
|
============
|
||||||
|
|
||||||
So you'd like to write some code to improve Django. Awesome! Browse the
|
So you'd like to write some code to improve Django? Awesome! There are several
|
||||||
following sections to find out how to give your code patches the best
|
ways you can help Django's development:
|
||||||
chances to be included in Django core:
|
|
||||||
|
* :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. You can also interact on
|
||||||
|
the `Django forum`_ and the `#django-dev IRC channel`_.
|
||||||
|
|
||||||
|
* :doc:`Submit patches <submitting-patches>` for new and/or fixed behavior. If
|
||||||
|
you're looking for a way to get started contributing to Django read the
|
||||||
|
:doc:`/intro/contributing` tutorial and have a look at the `easy pickings`_
|
||||||
|
tickets. The :ref:`patch-review-checklist` will also be helpful.
|
||||||
|
|
||||||
|
* :doc:`Improve the documentation <../writing-documentation>` or :doc:`write
|
||||||
|
unit tests <unit-tests>`.
|
||||||
|
|
||||||
|
* :doc:`Triage tickets and review patches <../triaging-tickets>` created by
|
||||||
|
other users.
|
||||||
|
|
||||||
|
* Read the :doc:`../new-contributors` to help you get orientated in the
|
||||||
|
development process.
|
||||||
|
|
||||||
|
Browse the following sections to find out how to give your code patches the
|
||||||
|
best chances to be included in Django core:
|
||||||
|
|
||||||
.. toctree::
|
.. toctree::
|
||||||
:maxdepth: 1
|
:maxdepth: 1
|
||||||
|
@ -14,3 +36,8 @@ chances to be included in Django core:
|
||||||
submitting-patches
|
submitting-patches
|
||||||
working-with-git
|
working-with-git
|
||||||
javascript
|
javascript
|
||||||
|
|
||||||
|
.. _ticket tracker: https://code.djangoproject.com/
|
||||||
|
.. _easy pickings: https://code.djangoproject.com/query?status=!closed&easy=1
|
||||||
|
.. _#django-dev IRC channel: https://webchat.freenode.net/#django-dev
|
||||||
|
.. _Django forum: https://forum.djangoproject.com/
|
||||||
|
|
Loading…
Reference in New Issue