[PATCH v2 0/6] docs: verify/bisect: fine tuning, testing fixes, build host, order

From: Thorsten Leemhuis
Date: Tue Apr 09 2024 - 03:32:06 EST


A quick series with various improvements for
Documentation/admin-guide/verify-bugs-and-bisect-regressions.rst after
receiving feedback on the text or seeing people struggle with certain
tasks.

* The first two patches contains various fixes and some fine tuning.

* The third is mainly a layout improvement that results in a somewhat
large patch.

* The fourth adds instructions for later testing of reverts, fixes, or
newer versions. This was already hinted at; but during some early
work on Documentation/admin-guide/reporting-issues.rst to better
reconcile the two it seemed wise to cover this properly here.

* The fifth patch briefly outlines how to build kernels on a different
host; it came into being after a second user within one week asked for
this. That also allowed the text to briefly cover cross-compilation.

* The sixth makes users that face a regression within a stable series
test that series first before they are told to test mainline.
---

Hi! While at it let me mention one more thing unrelated to the changes
that came up where I'm unsure if the current approach by the text was
a wise choice:

* Should the document tell users to avoid mainline during merge windows?

Some input from the community on this would be splendid.

Ciao, Thorsten

P.S.: Not totally sure, but I think this should go into 6.9 as this is
a new document; if not I guess it would be wise to pick the first two,
as they fix bugs.

Thorsten Leemhuis (6):
docs: verify/bisect: use git switch, tag kernel, and various fixes
docs: verify/bisect: add and fetch stable branches ahead of time
docs: verify/bisect: proper headlines and more spacing
docs: verify/bisect: explain testing reverts, patches and newer code
docs: verify/bisect: describe how to use a build host
docs: verify/bisect: stable regressions: first stable, then mainline

.../verify-bugs-and-bisect-regressions.rst | 597 ++++++++++++------
1 file changed, 417 insertions(+), 180 deletions(-)


base-commit: b8cfda5c9065cd619a97c17da081cbfab3b1e756
--
2.44.0