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

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]

Message-ID: <20190515074546.07700142@lwn.net>
Date:   Wed, 15 May 2019 07:45:46 -0600
From:   Jonathan Corbet <corbet@....net>
To:     Brendan Higgins <brendanhiggins@...gle.com>
Cc:     frowand.list@...il.com, gregkh@...uxfoundation.org,
        keescook@...gle.com, kieran.bingham@...asonboard.com,
        mcgrof@...nel.org, robh@...nel.org, sboyd@...nel.org,
        shuah@...nel.org, tytso@....edu, yamada.masahiro@...ionext.com,
        devicetree@...r.kernel.org, dri-devel@...ts.freedesktop.org,
        kunit-dev@...glegroups.com, linux-doc@...r.kernel.org,
        linux-fsdevel@...r.kernel.org, linux-kbuild@...r.kernel.org,
        linux-kernel@...r.kernel.org, linux-kselftest@...r.kernel.org,
        linux-nvdimm@...ts.01.org, linux-um@...ts.infradead.org,
        Alexander.Levin@...rosoft.com, Tim.Bird@...y.com,
        amir73il@...il.com, dan.carpenter@...cle.com,
        dan.j.williams@...el.com, daniel@...ll.ch, jdike@...toit.com,
        joel@....id.au, julia.lawall@...6.fr, khilman@...libre.com,
        knut.omang@...cle.com, logang@...tatee.com, mpe@...erman.id.au,
        pmladek@...e.com, rdunlap@...radead.org, richard@....at,
        rientjes@...gle.com, rostedt@...dmis.org, wfg@...ux.intel.com,
        Felix Guo <felixguoxiuping@...il.com>
Subject: Re: [PATCH v3 15/18] Documentation: kunit: add documentation for
 KUnit

On Tue, 14 May 2019 16:19:02 -0700
Brendan Higgins <brendanhiggins@...gle.com> 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