Re: [PATCH v3 15/18] Documentation: kunit: add documentation for KUnit

From: Jonathan Corbet
Date: Wed May 15 2019 - 09:47:41 EST


On Tue, 14 May 2019 16:19:02 -0700
Brendan Higgins <brendanhiggins@xxxxxxxxxx> wrote:

> Hmmm...probably premature to bring this up, but Documentation/dev-tools/
> is kind of thrown together.

Wait a minute, man... *I* created that directory, are you impugning my
work? :)

But yes, "kind of thrown together" is a good description of much of
Documentation/. A number of people have been working for years to make
that better, with some success, but there is a long way to go yet. The
dev-tools directory is an improvement over having that stuff scattered all
over the place â at least it's actually thrown together â but it's not the
end point.

> It would be nice to provide a coherent overview, maybe provide some
> basic grouping as well.
>
> It would be nice if there was kind of a gentle introduction to the
> tools, which ones you should be looking at, when, why, etc.

Total agreement. All we need is somebody to write it! :)

Thanks,

jon