Skip to content

docs: add a text about regressions to the Linux kernel's documentation

Thorsten Leemhuis linux-doc lkml regressions workflows 3 versions – In review

Get series with b4
b4 am [email protected]

Versions newest first · linked by author and title

  1. v3 Latest2 patches 6 repliesIn review
  2. v2 RFC2 patches 8 repliesSuperseded
  3. v1 RFC2 patches 12 repliesSuperseded

Changes in v3 from the cover letter

- drop RFC tag
- heavily reshuffled and slightly adjusted the text in the sections "The important bits for people fixing regressions" and "How to add a regression to regzbot's tracking somebody else reported?" to make them easier to grasp
- a few small fixes and improvements
- add ACK for the series from Greg (now for real)

Patches in v3 No applies recorded yet

#Subject and filesSizeRepliesApplied
1/2docs: add a document about regression handlingDocumentation/admin-guide/index.rst Documentation/admin-guide/regressions.rst MAINTAINERS+913 -06 replies
2/2docs: regressions.rst: rules of thumb for handling regressionsDocumentation/admin-guide/regressions.rst+81 -00 replies

Reviews trailers per patch

All 2 patches have a Reviewed-by or Acked-by.

PatchGreg Kroah-HartmanLukas Bulwahn
1/2A-b
2/2A-b R-b

Trailers given in replies are filled; those carried in the patches from earlier versions are outlined with dashes.

Read the v3 thread

Cover letter [PATCH v3 0/2] docs: add a text about regressions to the Linux kernel's documentation

'We don't cause regressions' might be the first rule of Linux kernel development, but it and other aspects of regressions nevertheless are hardly described in the Linux kernel's documentation. The following two patches change this by creating a document dedicated to the topic.

The second patch could easily be folded into the first one, but was kept separate, as it might be a bit controversial. This also allows the patch description to explain some backgrounds for this part of the document. Additionally, ACKs and Reviewed-by tags can be collected separately this way.

v3 (this mail):
- drop RFC tag
- heavily reshuffled and slightly adjusted the text in the sections "The important bits for people fixing regressions" and "How to add a regression to regzbot's tracking somebody else reported?" to make them easier to grasp
- a few small fixes and improvements
- add ACK for the series from Greg (now for real)

v2/RFC (https://lore.kernel.org/linux-doc/[email protected]/):
- a lot of small fixes, most are for spelling mistakes and grammar errors/problems pointed out in the review feedback I got so far
- add ACK for the series from Greg

v1/RFC (https://lore.kernel.org/linux-doc/[email protected]/):
- initial version

---

Hi! Merge window is over, so I'd like to move on with this. Dropped the RFC tag; I had a small hope Linus would take a look at this (especially the second patch) before I remove it; well, didn't work out, but Greg ACKed it, which is good enough reason to move on with this. :-D

Ciao, Thorsten

Thorsten Leemhuis (2):
docs: add a document about regression handling
docs: regressions.rst: rules of thumb for handling regressions

 Documentation/admin-guide/index.rst       |   1 +
 Documentation/admin-guide/regressions.rst | 992 ++++++++++++++++++++++
 MAINTAINERS                               |   1 +
 3 files changed, 994 insertions(+)
 create mode 100644 Documentation/admin-guide/regressions.rst

base-commit: e783362eb54cd99b2cac8b3a9aeac942e6f6ac07

Signature · 1 line
2.31.1