linux-kernel - Re: [PATCH v2] docs: add workload-tracing document to admin-guide

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] [thread-next>] [day] [month] [year] [list]

Message-ID: <f48e8dab-2a68-88d2-7917-f8f34a39e322@leemhuis.info>
Date:   Sat, 28 Jan 2023 09:35:22 +0100
From:   Thorsten Leemhuis <linux@...mhuis.info>
To:     Shuah Khan <skhan@...uxfoundation.org>, corbet@....net
Cc:     sshefali021@...il.com, kstewart@...uxfoundation.org,
        linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org
Subject: Re: [PATCH v2] docs: add workload-tracing document to admin-guide

Lo! One small quick question.

On 28.01.23 00:46, Shuah Khan wrote:
> Add a new section to the admin-guide with information of interest to
> application developers and system integrators doing analysis of the
> Linux kernel for safety critical applications.

That intro made my mind go "neither 'application developers' or 'system
integrators' are admins, so why is this added to the 'admin guide' then?"

That made me look up the into for the admin guide, which is
```
The Linux kernel user’s and administrator’s guide

The following is a collection of user-oriented documents that have been
added to the kernel over time. There is, as yet, little overall order or
organization here — this material was not written to be a single,
coherent document! With luck things will improve quickly over time.
```

Adding another section that doesn't seem to a be a good fit feels a bit
like "making things worse than better".  So wouldn't this maybe be a
good opportunity to create a totally new top-level section for
application developers and system integrators, even if it's tiny for
now? The audience is likely big enough to justify that -- and the topics
are likely different enough, too (of course sometimes there will be
overlap, as always). Any maybe it will help to bring other stuff over
from admin guide that is more targeted for application developers and
system integrators, which will help to get more structure into the
admin-guide.

Anyway, I have no strong feeling about this, just wanted to get this of
my chest.

Ciao, Thorsten