From 2ba2e801f679bade1f9325c71c312c3c0eaaf2a9 Mon Sep 17 00:00:00 2001
From: Abdulaziz Aloqeely <52792999+Aloqeely@users.noreply.github.com>
Date: Thu, 23 May 2024 07:28:32 +0300
Subject: [PATCH 1/3] DOC: Instruct to run git bisect when triaging a
 regression report

---
 doc/source/development/maintaining.rst | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/doc/source/development/maintaining.rst b/doc/source/development/maintaining.rst
index 4f4a1cd811b61..2cb06802d02b7 100644
--- a/doc/source/development/maintaining.rst
+++ b/doc/source/development/maintaining.rst
@@ -93,6 +93,9 @@ Here's a typical workflow for triaging a newly opened issue.
    If a reproducible example is provided, but you see a simplification,
    edit the original post with your simpler reproducible example.
 
+   If this is a regression report, post the result of a ``git bisect`` run.
+   More info on this can be found in the :ref:`maintaining.regressions` section.
+
    Ensure the issue exists on the main branch and that it has the "Needs Triage" tag
    until all steps have been completed. Add a comment to the issue once you have
    verified it exists on the main branch, so others know it has been confirmed.
@@ -125,7 +128,9 @@ Here's a typical workflow for triaging a newly opened issue.
    If the issue is clearly defined and the fix seems relatively straightforward,
    label the issue as "Good first issue".
 
-   Once you have completed the above, make sure to remove the "needs triage" label.
+   If the issue is a regression report, add the next patch release milestone.
+
+   Once you have completed the above, make sure to remove the "Needs Triage" label.
 
 .. _maintaining.regressions:
 

From 242c807cf99119609ab6456fc2ff8378ff9b5c48 Mon Sep 17 00:00:00 2001
From: Abdulaziz Aloqeely <52792999+Aloqeely@users.noreply.github.com>
Date: Thu, 23 May 2024 07:36:51 +0300
Subject: [PATCH 2/3] Fix typo

---
 doc/source/development/maintaining.rst | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/source/development/maintaining.rst b/doc/source/development/maintaining.rst
index 2cb06802d02b7..69ff563f91519 100644
--- a/doc/source/development/maintaining.rst
+++ b/doc/source/development/maintaining.rst
@@ -84,7 +84,7 @@ Here's a typical workflow for triaging a newly opened issue.
    example. See https://matthewrocklin.com/blog/work/2018/02/28/minimal-bug-reports
    for a good explanation. If the example is not reproducible, or if it's
    *clearly* not minimal, feel free to ask the reporter if they can provide
-   and example or simplify the provided one. Do acknowledge that writing
+   an example or simplify the provided one. Do acknowledge that writing
    minimal reproducible examples is hard work. If the reporter is struggling,
    you can try to write one yourself and we'll edit the original post to include it.
 

From d2b1b17369987307809ae800ed6b0c80b2f55cc8 Mon Sep 17 00:00:00 2001
From: Abdulaziz Aloqeely <52792999+Aloqeely@users.noreply.github.com>
Date: Thu, 23 May 2024 14:04:37 +0300
Subject: [PATCH 3/3] Suggest to add regression label

---
 doc/source/development/maintaining.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/source/development/maintaining.rst b/doc/source/development/maintaining.rst
index 69ff563f91519..fbcf017d608ce 100644
--- a/doc/source/development/maintaining.rst
+++ b/doc/source/development/maintaining.rst
@@ -128,7 +128,8 @@ Here's a typical workflow for triaging a newly opened issue.
    If the issue is clearly defined and the fix seems relatively straightforward,
    label the issue as "Good first issue".
 
-   If the issue is a regression report, add the next patch release milestone.
+   If the issue is a regression report, add the "Regression" label and the next patch
+   release milestone.
 
    Once you have completed the above, make sure to remove the "Needs Triage" label.