linux-kernel - Re: [PATCH v1] docs: new text on bisecting which also covers bug validation

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [day] [month] [year] [list]

Date: Sun, 03 Mar 2024 08:35:01 -0700
From: Jonathan Corbet <corbet@....net>
To: Vegard Nossum <vegard.nossum@...cle.com>, Thorsten Leemhuis
 <linux@...mhuis.info>
Cc: regressions@...ts.linux.dev, linux-doc@...r.kernel.org,
 linux-kernel@...r.kernel.org, Bagas Sanjaya <bagasdotme@...il.com>, Nathan
 Chancellor <nathan@...nel.org>
Subject: Re: [PATCH v1] docs: new text on bisecting which also covers bug
 validation

Vegard Nossum <vegard.nossum@...cle.com> writes:

> Something I really like about the current set of books is that they are,
> at least in theory, roughly divided by their target audience
> (user/admin, userspace dev, kernel dev).

That's good, since that was one of my primary goals when I took on the
docs maintainership :)

> I'd worry that "tutorials"
> as a top-level book would unintentionally end up as a very mixed bag of
> documents that don't have a clearly defined target audience.

Could be.  The thing is, there's two axes (at least) that can be used to
describe an audience.  One is who the readers are; that's what we have
been working toward over the years.  The other, though, is the type of
information they want, traditionally divided into tutorials, how-to
guides, explanations, and reference manuals.  Mixing those types (as we
do now) tends to lead to not doing any of them well.

Perhaps the bisection doc is more of a howto, now that I think of it.

Anyway, that is a problem that we're not going to be able to solve for
the 6.9 merge window, but adding this document is.

Thanks,

jon