Skip to content

Commit c6b3312

Browse files
Add triage sprint instructions page
1 parent 9222937 commit c6b3312

File tree

2 files changed

+57
-0
lines changed

2 files changed

+57
-0
lines changed

index.rst

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,7 @@ for your topic of interest. You can also use the search function in the top-left
4545
triage/workflow
4646
triage/guidelines
4747
triage/release_blockers
48+
triage/sprint_instructions
4849

4950
.. toctree::
5051
:hidden:

triage/sprint_instructions.rst

Lines changed: 56 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,56 @@
1+
.. _doc_bug_triage_sprint_instructions:
2+
3+
.. note::
4+
5+
The bugsquad regularly hosts sprints where anyone can participate, this page contains instructions
6+
for participating in these, sprints are organized in the
7+
`#bugsquad-sprints <https://chat.godotengine.org/channel/bugsquad-sprints>`__ channel, subscribe
8+
to get updates when new sprints are announced.
9+
10+
.. TODO: Add link to instructions for organizing sprints here once written.
11+
12+
Participating in triage sprints
13+
===============================
14+
15+
Each sprint discussion thread has a number of threads with batches of issues to test. To participate, please claim a
16+
batch by commenting on its thread (if it is free). Please don't start working on a batch without claiming it,
17+
even if you are unsure if you can finish all the issues in time, to avoid duplicating work. If you have finished a batch,
18+
and are interested in doing more and feel you have the time to complete one more, you can claim a second batch if there
19+
are any open batches. But please claim only **one** batch at a time.
20+
21+
Please ask any questions or updates about issues relating to a batch in the thread of that batch.
22+
23+
Sprint steps
24+
------------
25+
26+
- Read through the issue conversation and see if there's some pending request, for example someone asking for an MRP or clarification.
27+
28+
- If there is, and the information is still missing, please comment with the issue report link in the batch thread and we will close it
29+
due to inactivity. This might apply even if the thread has replies after the request if those replies do not provide the necessary information.
30+
If you are unsure please comment in the batch thread and we will evaluate it.
31+
32+
- Confirm that the report is filled in correctly, that all the necessary details are available.
33+
34+
- If something is missing, please comment on the issue asking for more information, or comment in the batch thread with the issue
35+
report link and we will do it.
36+
37+
- See if you recognize this issue from somewhere else, it might be a duplicate.
38+
39+
- If it is a duplicate, please comment on the issue linking to the (possible) duplicate, or comment in the batch thread.
40+
41+
- Test the issue if you are able.
42+
43+
- If the issue is specific to some platform or hardware you do not have, comment with the issue report link in the sprint
44+
discussion (**not** in the batch thread but the main sprint discussion), and create a thread under it, and someone else can
45+
test it if they are able.
46+
- Otherwise report the result of testing it on the issue itself, including what version(s) you tested it on and other details
47+
such as OS, hardware, etc. This includes if you are unable to confirm the issue. If you are unsure if you followed the steps
48+
correctly, or if they end up being unclear when you try to test the issue, please comment asking for clarification.
49+
50+
If you need help updating any details on the issue, such as fixing the title, any tags or trackers, etc., please tag the person organizing the sprint
51+
in an issue comment, or ask in the batch thread.
52+
53+
When you are done with the batch please comment in the batch thread. You can report the result of your triage as you go through them or at the end,
54+
but please make it clear when you are done so we can go through and check the issues, and know when the sprint is done.
55+
56+
For more details on the general triage workflow, please see :ref:`doc_bug_triage_overview`.

0 commit comments

Comments
 (0)