mirrors/django
1
0
Fork 0
mirror of https://github.com/django/django.git synced 2025-03-31 03:30:46 +00:00
Code Issues 32 Releases Wiki Activity

Turned the triage attributes to actual sections so they can be more easily linked to in the documentation.

Browse Source
This commit is contained in:
Julien Phalip 2013-04-10 17:11:26 -07:00
parent e7b9c11c3f
commit 68d6c52ed6
1 changed files with 61 additions and 20 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

81
docs/internals/contributing/triaging-tickets.txt
View File

@ -168,28 +168,41 @@ Other triage attributes
A number of flags, appearing as checkboxes in Trac, can be set on a ticket: A number of flags, appearing as checkboxes in Trac, can be set on a ticket:
* Has patch Has patch
This means the ticket has an associated ~~~~~~~~~
:doc:`patch<writing-code/submitting-patches>`. These will be reviewed
to see if the patch is "good".
* Needs documentation: This means the ticket has an associated
This flag is used for tickets with patches that need associated :doc:`patch<writing-code/submitting-patches>`. These will be reviewed
documentation. Complete documentation of features is a prerequisite to see if the patch is "good".
before we can check them into the codebase.
* Needs tests Needs documentation
This flags the patch as needing associated unit tests. Again, this ~~~~~~~~~~~~~~~~~~~
is a required part of a valid patch.
* Patch needs improvement This flag is used for tickets with patches that need associated
This flag means that although the ticket *has* a patch, it's not quite documentation. Complete documentation of features is a prerequisite
ready for checkin. This could mean the patch no longer applies before we can check them into the codebase.
cleanly, there is a flaw in the implementation, or that the code
doesn't meet our standards.
* Easy pickings Needs tests
Tickets that would require small, easy, patches. ~~~~~~~~~~~
This flags the patch as needing associated unit tests. Again, this
is a required part of a valid patch.
Patch needs improvement
~~~~~~~~~~~~~~~~~~~~~~~
This flag means that although the ticket *has* a patch, it's not quite
ready for checkin. This could mean the patch no longer applies
cleanly, there is a flaw in the implementation, or that the code
doesn't meet our standards.
Easy pickings
~~~~~~~~~~~~~
Tickets that would require small, easy, patches.
Type
~~~~
Tickets should be categorized by *type* between: Tickets should be categorized by *type* between:
@ -203,19 +216,47 @@ Tickets should be categorized by *type* between:
For when nothing is broken but something could be made cleaner, For when nothing is broken but something could be made cleaner,
better, faster, stronger. better, faster, stronger.
Tickets should also be classified into *components* indicating which area of Component
~~~~~~~~~
Tickets should be classified into *components* indicating which area of
the Django codebase they belong to. This makes tickets better organized and the Django codebase they belong to. This makes tickets better organized and
easier to find. easier to find.
Severity
~~~~~~~~
The *severity* attribute is used to identify blockers, that is, issues which The *severity* attribute is used to identify blockers, that is, issues which
should get fixed before releasing the next version of Django. Typically those should get fixed before releasing the next version of Django. Typically those
issues are bugs causing regressions from earlier versions or potentially issues are bugs causing regressions from earlier versions or potentially
causing severe data losses. This attribute is quite rarely used and the vast causing severe data losses. This attribute is quite rarely used and the vast
majority of tickets have a severity of "Normal". majority of tickets have a severity of "Normal".
Finally, it is possible to use the *version* attribute to indicate in which Version
~~~~~~~
It is possible to use the *version* attribute to indicate in which
version the reported bug was identified. version the reported bug was identified.
UI/UX
~~~~~
This flag is used for tickets that relate to User Interface and User
Experiences questions. For example, this flag would be appropriate for
user-facing features in forms or the admin interface.
Cc
~~
You may add your username or email address to this field to be notified when
new contributions are made to the ticket.
Keywords
~~~~~~~~
With this field you may label a ticket with multiple keywords. This can be
useful, for example, to group several tickets of a same theme.
.. _closing-tickets: .. _closing-tickets:
Closing Tickets Closing Tickets