linux.git/Documentation/process/stable-kernel-rules.rst, branch v6.12.80

docs: stable-kernel-rules: fix typo sent->send

2024-05-02T16:20:27+00:00

Change 'sent' to 'send'

Signed-off-by: Tim Bird 
Link: https://lore.kernel.org/r/SA3PR13MB63726A746C847D7C0919C25BFD162@SA3PR13MB6372.namprd13.prod.outlook.com
Reviewed-by: Greg Kroah-Hartman 
Signed-off-by: Jonathan Corbet

docs: stable-kernel-rules: create special tag to flag 'no backporting'

2024-05-02T16:09:17+00:00

Document a new variant of the stable tag developers can use to make the
stable team's tools ignore a change[1].

That way developers can use 'Fixes:' tags without fearing the changes
might be backported in semi-automatic fashion. Such concerns are the
reason why some developers deliberately omit the 'Fixes:' tag in
changes[2] -- which somewhat undermines the reason for the existence of
that tag and might be unwise in the long term[3].

Link: https://lore.kernel.org/all/b452fd54-fdc6-47e4-8c26-6627f6b7eff3@leemhuis.info/ [1]
Link: https://lore.kernel.org/all/cover.1712226175.git.antony.antony@secunet.com/ [2]
Link: https://lore.kernel.org/all/dfd87673-c581-4b4b-b37a-1cf5c817240d@leemhuis.info/ [3]
Signed-off-by: Thorsten Leemhuis 
Reviewed-by: Greg Kroah-Hartman 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/35989d3b2f3f8cf23828b0c84fde9b17a74be97c.1714367921.git.linux@leemhuis.info

docs: stable-kernel-rules: explain use of stable@kernel.org (w/o @vger.)

2024-05-02T16:09:17+00:00

Document when to use of stable@kernel.org instead of
stable@vger.kernel.org, as the two are easily mixed up and their
difference not explained anywhere[1].

Link: https://lore.kernel.org/all/20240422231550.3cf5f723@sal.lan/ [1]
Signed-off-by: Thorsten Leemhuis 
Reviewed-by: Greg Kroah-Hartman 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/6783b71da48aac5290756343f58591dc42da87bc.1714367921.git.linux@leemhuis.info

docs: stable-kernel-rules: remove code-labels tags and a indention level

2024-05-02T16:09:17+00:00

Remove the 'code-block:: none' labels and switch to the shorter '::' to
reduce noise.

Remove a unneeded level of indentation, as that reduces the chance that
readers have to scroll sideways in some of the code blocks.

No text changes. Rendered html output looks like before, except for the
different level of indentation.

CC: Jonathan Corbet 
Signed-off-by: Thorsten Leemhuis 
Reviewed-by: Greg Kroah-Hartman 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/755afbeafc8e1457154cb4b30ff4397f34326679.1714367921.git.linux@leemhuis.info

docs: stable-kernel-rules: call mainline by its name and change example

2024-05-02T16:09:17+00:00

Fine-tuning:

* s/Linus' tree/Linux mainline/, as mainline is the term used elsewhere
  in the document.

* Provide a better example for the 'delayed backporting' case that uses
  a fixed rather than a relative reference point, which makes it easier
  to handle for the stable team.

Signed-off-by: Thorsten Leemhuis 
Reviewed-by: Greg Kroah-Hartman 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/0a120573ea827aee12d45e7bd802ba85c09884da.1714367921.git.linux@leemhuis.info

docs: stable-kernel-rules: reduce redundancy

2024-05-02T16:09:17+00:00

Explain the general concept once in the intro to keep things somewhat
shorter in the individual points.

Reviewed-by: Greg Kroah-Hartman 
Signed-off-by: Thorsten Leemhuis 
Signed-off-by: Jonathan Corbet 
Link: https://lore.kernel.org/r/106e21789e2bf02d174e1715b49cd4d30886d51f.1714367921.git.linux@leemhuis.info

Documentation: stable: clarify patch series prerequisites

2023-10-05T11:43:45+00:00

Add some clarifications for patches that have dependencies within the
patch series.

Signed-off-by: Hugo Villeneuve 
Rule: add
Link: https://lore.kernel.org/stable/20230911203628.20068-1-hugo%40hugovil.com
Link: https://lore.kernel.org/r/20230911203628.20068-1-hugo@hugovil.com
Signed-off-by: Greg Kroah-Hartman

docs: stable-kernel-rules: mention that regressions must be prevented

2023-08-12T11:03:28+00:00

Document that changes intended for a specific stable series have to be
in all newer series still maintained, as otherwise users would run into
regressions.

CC: Greg KH 
CC: Sasha Levin 
CC: Jonathan Corbet 
Signed-off-by: Thorsten Leemhuis 
Link: https://lore.kernel.org/r/ddb5cb0d6b7aa4ef31642cd9657a0fb53d79cddb.1691219455.git.linux@leemhuis.info
Signed-off-by: Greg Kroah-Hartman

docs: stable-kernel-rules: fine-tune various details

2023-08-12T11:03:28+00:00

* various fine tuning to the text that cleans up rough edges the three
  previous preparatory patches left behind to keep the diffs simpler
* s/Linus' tree/mainline/g, as that's the term more commonly used and
  known
* create a short intro for the three submission options and streamline
  the explanation when to use which of them
* fix a >= vs <= thinko in an example to make it more straight forward
* there were two blank lines before some sub-headings and just one
  before others; use the former style everywhere

CC: Greg KH 
CC: Sasha Levin 
CC: Jonathan Corbet 
Signed-off-by: Thorsten Leemhuis 
Link: https://lore.kernel.org/r/e1960a70acae2c2f18b838aee9f8bf6055fae89b.1691219455.git.linux@leemhuis.info
Signed-off-by: Greg Kroah-Hartman

docs: stable-kernel-rules: make the examples for option 1 a proper list

2023-08-12T11:03:28+00:00

Separate the description for option 1 and the examples how to use it by
making the latter an indented unordered list.

No text changes.

CC: Greg KH 
CC: Sasha Levin 
CC: Jonathan Corbet 
Signed-off-by: Thorsten Leemhuis 
Link: https://lore.kernel.org/r/59deaabfabf0629d7cf2a52b196cec19d1f9ec47.1691219455.git.linux@leemhuis.info
Signed-off-by: Greg Kroah-Hartman