Message-ID: <f48e8dab-2a68-88d2-7917-f8f34a39e322@leemhuis.info>
Date:   Sat, 28 Jan 2023 09:35:22 +0100
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101
 Thunderbird/102.6.0
Content-Language: en-US, de-DE
To:     Shuah Khan <skhan@linuxfoundation.org>, corbet@lwn.net
Cc:     sshefali021@gmail.com, kstewart@linuxfoundation.org,
        linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org
References: <20230127234616.55137-1-skhan@linuxfoundation.org>
From:   Thorsten Leemhuis <linux@leemhuis.info>
Subject: Re: [PATCH v2] docs: add workload-tracing document to admin-guide
In-Reply-To: <20230127234616.55137-1-skhan@linuxfoundation.org>
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Precedence: bulk

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