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

[Jonathan Corbet <corbet@lwn.net>]

Vegard Nossum <vegard.nossum@oracle.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