|
@@ -6,63 +6,20 @@ Django is a community that lives on its volunteers. As it keeps growing, we
|
|
|
always need more people to help others. You can contribute in many ways, either
|
|
|
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 is always looking for translators to help maintain
|
|
|
-and increase language reach.
|
|
|
-
|
|
|
-See :doc:`localizing` to help translate Django.
|
|
|
-
|
|
|
-Contributing guide 📖
|
|
|
-=====================
|
|
|
-
|
|
|
-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!
|
|
|
+Communication channels
|
|
|
+======================
|
|
|
|
|
|
-This contributing guide contains everything you need to know to help build the
|
|
|
-Django web framework. Browse the following sections to find out how:
|
|
|
+We're passionate about helping Django users make the jump to contributing
|
|
|
+members of the community. Communication is key - working on Django is being
|
|
|
+part of a conversation. Join it, to become familiar with what we're doing and
|
|
|
+how we talk about it. You'll be able to form relationships with more
|
|
|
+experienced contributors who are there to help guide you towards success.
|
|
|
|
|
|
-.. toctree::
|
|
|
- :maxdepth: 2
|
|
|
+Join the Django community
|
|
|
+-------------------------
|
|
|
|
|
|
- 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:
|
|
|
+There are several 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
|
|
|
framework and applications and projects that use it. This is also a good
|
|
@@ -87,11 +44,86 @@ Django community and others to maintain a great ecosystem to work in:
|
|
|
ecosystem of pluggable applications is a big strength of Django, help us
|
|
|
build it!
|
|
|
|
|
|
-We're looking forward to working with you. Welcome aboard! ⛵️
|
|
|
-
|
|
|
.. _posting guidelines: https://code.djangoproject.com/wiki/UsingTheMailingList
|
|
|
.. _#django IRC channel: https://web.libera.chat/#django
|
|
|
+.. _#django-dev IRC channel: https://web.libera.chat/#django-dev
|
|
|
.. _community page: https://www.djangoproject.com/community/
|
|
|
.. _Django Discord server: https://discord.gg/xcRH6mN4fa
|
|
|
.. _Django forum: https://forum.djangoproject.com/
|
|
|
.. _register it here: https://www.djangoproject.com/community/add/blogs/
|
|
|
+
|
|
|
+Getting started
|
|
|
+===============
|
|
|
+
|
|
|
+Django encourages and welcomes new contributors, and makes an effort to help
|
|
|
+them become experienced, confident contributors to Open Source Software (OSS).
|
|
|
+Our documentation contains guidance for first-time contributors, including:
|
|
|
+
|
|
|
+.. toctree::
|
|
|
+ :maxdepth: 1
|
|
|
+
|
|
|
+ An overview of the contributing process and what's involved. <new-contributors>
|
|
|
+
|
|
|
+Work on the Django framework
|
|
|
+============================
|
|
|
+
|
|
|
+If you enjoy working *with* Django, wait until you start working *on* it.
|
|
|
+Really, **anyone** can do something to improve Django, which will improve the
|
|
|
+experience 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 see **your
|
|
|
+code** in the next version of Django.
|
|
|
+
|
|
|
+.. toctree::
|
|
|
+ :maxdepth: 2
|
|
|
+
|
|
|
+ writing-code/index
|
|
|
+
|
|
|
+Contributing 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.
|
|
|
+
|
|
|
+.. toctree::
|
|
|
+ :maxdepth: 2
|
|
|
+
|
|
|
+ writing-documentation
|
|
|
+
|
|
|
+Localizing Django
|
|
|
+-----------------
|
|
|
+
|
|
|
+Django is translated into over 100 languages - There's even some translation
|
|
|
+for Klingon?! The i18n team is always looking for translators to help maintain
|
|
|
+and increase language reach.
|
|
|
+
|
|
|
+.. toctree::
|
|
|
+ :maxdepth: 2
|
|
|
+
|
|
|
+ localizing
|
|
|
+
|
|
|
+Other ways of contributing
|
|
|
+==========================
|
|
|
+
|
|
|
+Explore additional avenues of contributing to Django beyond coding. Django's
|
|
|
+`ticket tracker`_ is the central hub for managing issues, improvements, and
|
|
|
+contributions to Django. It's a valuable resource where you can report bugs you
|
|
|
+encounter or assist in triaging existing tickets to ensure a smooth development
|
|
|
+workflow. Explore the ways you can make a difference below, and join us in
|
|
|
+making Django better for everyone.
|
|
|
+
|
|
|
+.. toctree::
|
|
|
+ :maxdepth: 2
|
|
|
+
|
|
|
+ bugs-and-features
|
|
|
+ triaging-tickets
|
|
|
+
|
|
|
+.. _ticket tracker: https://code.djangoproject.com/
|
|
|
+
|
|
|
+We're looking forward to working with you. Welcome aboard!
|