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

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

v1/RFC:
- initial version

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 | 947 ++++++++++++++++++++++
 MAINTAINERS                               |   1 +
 3 files changed, 949 insertions(+)
 create mode 100644 Documentation/admin-guide/regressions.rst


base-commit: b36064425a18e29a3bad9c007b4dd1223f8aadc5
-- 
2.31.1

On Mon, Jan 03, 2022 at 10:50:49AM +0100, Thorsten Leemhuis wrote:
> 'We don't cause regressions' might be the first rule of kernel development, but
> it and other aspects of regressions nevertheless are hardly described in the
> Linux kernel's documentation. These patches change this by creating a document
> dedicated to the topic.
> 
> The second patch could easily be folded into the first one, but I kept it
> separate, as it might be a bit controversial. This also allows the patch
> description to explain some backgrounds for this part of the text. Additionally,
> ACKs and Reviewed-by tags can be collected separately this way.

Acked-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>