Skip to content

[Triage] Document organizing triage sprints - #95

Open
AThousandShips wants to merge 1 commit into
godotengine:mainfrom
AThousandShips:sprint_instructions
Open

[Triage] Document organizing triage sprints#95
AThousandShips wants to merge 1 commit into
godotengine:mainfrom
AThousandShips:sprint_instructions

Conversation

@AThousandShips

Copy link
Copy Markdown
Member

Still work in progress working on a few details but creating for review

@AThousandShips AThousandShips added enhancement New feature or request content:new page Issues and PRs related to creation of new documentation pages for new or undocumented features labels Jul 23, 2026
@rsubtil
rsubtil self-requested a review July 25, 2026 11:49

@rsubtil rsubtil left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks clear and concise! I only have some minor notes, mostly spelling/grammatical ones.

Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
@AThousandShips
AThousandShips marked this pull request as ready for review July 27, 2026 15:15
@AThousandShips
AThousandShips requested a review from a team July 28, 2026 15:37

@rsubtil rsubtil left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM!

Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated

@Calinou Calinou left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think we should avoid capitalizing Sprint across the page, but other than that, this looks good to me at a glance.

@AThousandShips
AThousandShips force-pushed the sprint_instructions branch 2 times, most recently from 2cdf40f to 0952b80 Compare August 4, 2026 15:13
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated
a message for each batch, ``Batch 1``, ``Batch 2``, etc., and make a thread for each. Put the list of issues as a message in this thread and add
"Comment here to claim this batch." at the end.

After the batches add another separator and then a questions thread and another one for feedback, followed by another separator.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Phrasing here feels a bit clunky, although a specific way to revise it isn't coming to mind for me right now.

Comment thread other/triage/triage_sprint_organization.rst
Comment thread other/triage/triage_sprint_organization.rst Outdated
Comment thread other/triage/triage_sprint_organization.rst Outdated

For instructions for participating in triage sprints, see :ref:`doc_bug_triage_sprint_instructions`.

These are instructions for organizing triage sprints.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I feel like this is a bit redundant. I recognize that this page is intended for the bugsquad team, whose members are presumably already familiar with what a "triage sprint" is, but perhaps this bit at the top of the page could provide a short explanation for others who may happen upon the page?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the link to the sprint instructions are sufficient as they explain what a sprint is

Comment thread other/triage/triage_sprint_organization.rst Outdated
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content:new page Issues and PRs related to creation of new documentation pages for new or undocumented features enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants