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