Skip to content

docs: add instruction about handling regressions to our core texts for contributors

Thorsten Leemhuis linux-doc regressions workflows 1 version In review

Get series with b4
b4 am [email protected]

Versions newest first

  1. v1 Latest6 patches 12 repliesIn review

Changes in v1 from the cover letter

- initial version

Patches in v1 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/6docs: more detailed instructions on handling regressionsDocumentation/process/6.Followthrough.rst Documentation/process/handling-regressions.rst Documentation/process/submitting-patches.rst+68 -272 replies
2/6docs: 6.Followthrough.rst: when to involved Linus in regressionsDocumentation/process/6.Followthrough.rst Documentation/process/handling-regressions.rst+17 -172 replies
3/6docs: 6.Followthrough.rst: interaction with stable wrt to regressionsDocumentation/process/6.Followthrough.rst Documentation/process/handling-regressions.rst+22 -192 replies
4/6docs: 6.Followthrough.rst: tags to use in regressions fixesDocumentation/process/6.Followthrough.rst Documentation/process/handling-regressions.rst+16 -72 replies
5/6docs: 6.Followthrough.rst: more specific advice on fixing regressionsDocumentation/process/6.Followthrough.rst Documentation/process/handling-regressions.rst+23 -472 replies
6/6docs: 6.Followthrough.rst: advice on handling regressions fixesDocumentation/process/6.Followthrough.rst Documentation/process/handling-regressions.rst+21 -192 replies

Reviews trailers per patch

No Reviewed-by, Acked-by or Tested-by trailers for v1 yet.

Read the v1 thread

Cover letter [PATCH v1 0/6] docs: add instruction about handling regressions to our core texts for contributors

Add some more detailed instruction on handling regressions to our core texts for contributors, e.g. Documentation/process/6.Followthrough.rst and Documentation/process/submitting-patches.rst. This was asked for at the last Maintainer Summit[1] and is meant to help clarifing what's expected.

The added instructions are somewhat inspired by existing and sometimes similar text in Documentation/process/handling-regressions.rst which is semoved during the series.

The patch-set starts with some basics, which are based on the existing text or recent statements from Linus. I tried to stay close to what was said, but used my own words here -- if I got something wrong just tell me so I can fix this.

The guidelines then are extended in multiple steps to cover more things and be more specific in some areas. Some of that is meant to work against problems I noticed during my regression tracking work. Most of these are my words. These thus need to be discussed properly and in the end ideally ACKed by Linus, so we all know what he wants. The parts I expect to get more discussion are found near the end of the patchset.

---

v1:
- initial version

Thorsten Leemhuis (6):
docs: more detailed instructions on handling regressions
docs: 6.Followthrough.rst: when to involved Linus in regressions
docs: 6.Followthrough.rst: interaction with stable wrt to regressions
docs: 6.Followthrough.rst: tags to use in regressions fixes
docs: 6.Followthrough.rst: more specific advice on fixing regressions
docs: 6.Followthrough.rst: advice on handling regressions fixes

 Documentation/process/6.Followthrough.rst     | 152 ++++++++++++++++--
 .../process/handling-regressions.rst          | 111 +------------
 Documentation/process/submitting-patches.rst  |  20 +++
 3 files changed, 157 insertions(+), 126 deletions(-)

base-commit: 010a08cbf0d63b246c4cd0d385c3f664add2322d

Signature · 1 line
2.45.0