diff --git a/docs/internals/contributing/committing-code.txt b/docs/internals/contributing/committing-code.txt index d853d643fa..136ef25728 100644 --- a/docs/internals/contributing/committing-code.txt +++ b/docs/internals/contributing/committing-code.txt @@ -2,9 +2,9 @@ Committing code =============== -This section is addressed to the :doc:`/internals/team` and to anyone -interested in knowing how code gets committed into Django core. If you're a -community member who wants to contribute code to Django, have a look at +This section is addressed to the :ref:`committers` and to anyone interested in +knowing how code gets committed into Django core. If you're a community member +who wants to contribute code to Django, have a look at :doc:`writing-code/working-with-git` instead. .. _handling-pull-requests: @@ -109,7 +109,7 @@ Django's Git repository: If you bring something up on |django-developers| and nobody responds, please don't take that to mean your idea is great and should be - implemented immediately because nobody contested it. Django's lead + implemented immediately because nobody contested it. Django's core developers don't have a lot of time to read mailing-list discussions immediately, so you may have to wait a couple of days before getting a response. @@ -142,7 +142,7 @@ Django's Git repository: use frequent small commits rather than infrequent large commits. For example, if implementing feature X requires a small change to library Y, first commit the change to library Y, then commit feature X in a - separate commit. This goes a *long way* in helping all core Django + separate commit. This goes a *long way* in helping all Django core developers follow your changes. * Separate bug fixes from feature changes. Bugfixes may need to be backported @@ -169,7 +169,6 @@ Django's Git repository: commit message, GitHub will close the pull request, but the Trac plugin will also close the same numbered ticket in Trac. - .. _Trac plugin: https://github.com/aaugustin/trac-github * If your commit references a ticket in the Django `ticket tracker`_ but diff --git a/docs/internals/contributing/new-contributors.txt b/docs/internals/contributing/new-contributors.txt index 80a87f1e8f..2e55114a66 100644 --- a/docs/internals/contributing/new-contributors.txt +++ b/docs/internals/contributing/new-contributors.txt @@ -102,8 +102,8 @@ some advice to make your work on Django more useful and rewarding. Sometimes it can be scary to put your opinion out to the world and say "this ticket is correct" or "this patch needs work", but it's the only way the project moves forward. The contributions of the broad Django community - ultimately have a much greater impact than that of the core developers. We - can't do it without YOU! + ultimately have a much greater impact than that of the core team. We can't + do it without **you**! * **Err on the side of caution when marking things Ready For Check-in** @@ -138,10 +138,10 @@ FAQ I do to get it committed?** First off, it's not personal. Django is entirely developed by volunteers - (even the core developers), and sometimes folks just don't have time. The - best thing to do is to send a gentle reminder to the |django-developers| - mailing list asking for review on the ticket, or to bring it up in the - #django-dev IRC channel. + (even the core team), and sometimes folks just don't have time. The best + thing to do is to send a gentle reminder to the |django-developers| mailing + list asking for review on the ticket, or to bring it up in the #django-dev + IRC channel. 2. **I'm sure my ticket is absolutely 100% perfect, can I mark it as RFC myself?** diff --git a/docs/internals/contributing/triaging-tickets.txt b/docs/internals/contributing/triaging-tickets.txt index f274c2ab68..8c5aed5e3e 100644 --- a/docs/internals/contributing/triaging-tickets.txt +++ b/docs/internals/contributing/triaging-tickets.txt @@ -29,7 +29,7 @@ possible, and raise issues for discussion on our mailing lists when there is confusion or disagreement. Django is a community project, and every contribution helps. We can't do this -without YOU! +without **you**! Triage workflow --------------- @@ -146,7 +146,7 @@ Ready For Checkin The ticket was reviewed by any member of the community other than the person who supplied the patch and found to meet all the requirements for a -commit-ready patch. A core committer now needs to give the patch a final +commit-ready patch. A committer now needs to give the patch a final review prior to being committed. See the :ref:`New contributors' FAQ` for "My ticket has been in RFC forever! What should I do?" diff --git a/docs/internals/git.txt b/docs/internals/git.txt index 07837bac47..45d137b1ce 100644 --- a/docs/internals/git.txt +++ b/docs/internals/git.txt @@ -243,7 +243,8 @@ branches, used for Google Summer of Code projects. Tags ==== -Each Django release is tagged and signed by Django's release manager. +Each Django release is tagged and signed by a :ref:`releaser +`. The tags can be found on GitHub's `tags`_ page. diff --git a/docs/internals/index.txt b/docs/internals/index.txt index 807283f0d0..415e6bfeb5 100644 --- a/docs/internals/index.txt +++ b/docs/internals/index.txt @@ -2,16 +2,7 @@ Django internals ================ Documentation for people hacking on Django itself. This is the place to go if -you'd like to help improve Django, learn or learn about how Django works "under -the hood". - -.. warning:: - - Elsewhere in the Django documentation, coverage of a feature is a sort of a - contract: once an API is in the official documentation, we consider it - "stable" and don't change it without a good reason. APIs covered here, - however, are considered "internal-only": we reserve the right to change - these internals if we must. +you'd like to help improve Django or learn about how Django is managed. .. toctree:: :maxdepth: 2 diff --git a/docs/internals/mailing-lists.txt b/docs/internals/mailing-lists.txt index 4f31cb6466..fc2fa320f0 100644 --- a/docs/internals/mailing-lists.txt +++ b/docs/internals/mailing-lists.txt @@ -40,9 +40,9 @@ installation, usage, or debugging of Django. ``django-core-mentorship`` -------------------------- -The Django Core Development Mentorship list is intended to provide a welcoming -introductory environment for developers interested in contributing to core -Django development. +The Django Core Mentorship list is intended to provide a welcoming +introductory environment for community members interested in contributing to +the Django Project. * `django-core-mentorship mailing archive`_ * `django-core-mentorship subscription email address`_ diff --git a/docs/internals/organization.txt b/docs/internals/organization.txt index 3f2423114b..17caf54583 100644 --- a/docs/internals/organization.txt +++ b/docs/internals/organization.txt @@ -33,6 +33,8 @@ Until 2014, the Django Project was a benevolent_ dictatorship_. .. _benevolent: http://www.holovaty.com/writing/bdfls-retiring/ .. _dictatorship: http://jacobian.org/writing/retiring-as-bdfls/ +.. _core-team: + Core team ========= @@ -130,6 +132,8 @@ contribution in two years may be asked to move themselves to this category, and moved there if they don't respond. Past team members lose their privileges such as voting rights and commit access. +.. _technical-board: + Technical board =============== diff --git a/docs/internals/release-process.txt b/docs/internals/release-process.txt index 26343a1bbd..c470273391 100644 --- a/docs/internals/release-process.txt +++ b/docs/internals/release-process.txt @@ -144,11 +144,11 @@ Release process Django uses a time-based release schedule, with major (i.e. 1.6, 1.7, etc.) releases every nine months, or more, depending on features. -After each release, and after a suitable cooling-off period of a few weeks, the -core development team will examine the landscape and announce a timeline for the -next release. Most releases will be scheduled in the 6-9 month range, but if we -have bigger features to development we might schedule a longer period to allow -for more ambitious work. +After each release, and after a suitable cooling-off period of a few weeks, +core developers will examine the landscape and announce a timeline for the +next release. Most releases will be scheduled in the 6-9 month range, but if +we have bigger features to development we might schedule a longer period to +allow for more ambitious work. Release cycle ------------- diff --git a/docs/internals/roles.txt b/docs/internals/roles.txt index 9bfd5f4c00..46ffdbb2ec 100644 --- a/docs/internals/roles.txt +++ b/docs/internals/roles.txt @@ -9,6 +9,8 @@ Technical board The first technical board hasn't been elected yet. +.. _committers: + Committers ========== @@ -17,6 +19,8 @@ Most :ref:`core team ` members have commit access. They're called Being part of the core team is a pre-requisite for having commit access. +.. _security-team-list: + Security team ============= @@ -35,6 +39,8 @@ The current security team members are: - Carl Meyer - Donald Stufft +.. _releasers-list: + Releasers ========= diff --git a/docs/internals/security.txt b/docs/internals/security.txt index 20ab81a8ab..4dc6994f36 100644 --- a/docs/internals/security.txt +++ b/docs/internals/security.txt @@ -19,21 +19,20 @@ Reporting security issues **Short version: please report security issues by emailing security@djangoproject.com**. -Most normal bugs in Django are reported to `our public Trac -instance`_, but due to the sensitive nature of security issues, we ask -that they **not** be publicly reported in this fashion. +Most normal bugs in Django are reported to `our public Trac instance`_, but +due to the sensitive nature of security issues, we ask that they **not** be +publicly reported in this fashion. -Instead, if you believe you've found something in Django which has -security implications, please send a description of the issue via -email to ``security@djangoproject.com``. Mail sent to that address -reaches a subset of the core development team, who can forward -security issues into the private committers' mailing list for broader -discussion if needed. +Instead, if you believe you've found something in Django which has security +implications, please send a description of the issue via email to +``security@djangoproject.com``. Mail sent to that address reaches a +:ref:`subset of the core team `, who can forward security +issues into the private committers' mailing list for broader discussion if +needed. -Once you've submitted an issue via email, you should receive an -acknowledgment from a member of the Django development team within 48 -hours, and depending on the action to be taken, you may receive -further followup emails. +Once you've submitted an issue via email, you should receive an acknowledgment +from a member of the security team within 48 hours, and depending on the +action to be taken, you may receive further followup emails. .. note:: diff --git a/docs/internals/team.txt b/docs/internals/team.txt index f3fdc5c88d..f18a4b8bcd 100644 --- a/docs/internals/team.txt +++ b/docs/internals/team.txt @@ -62,12 +62,10 @@ Journal-World`_ of Lawrence, Kansas, USA. The current team ================ -Currently, Django is led by a team of volunteers from around the globe. - These are the folks who have a long history of contributions, a solid track record of being helpful on the mailing lists, and a proven desire to dedicate -serious time to Django. In return, they've been granted the coveted commit bit, -and have free rein to hack on all parts of Django. +serious time to Django. In return, they've been invited to join the :ref:`core +team `. Malcolm Tredinnick Malcolm originally wanted to be a mathematician, somehow ended up a software