[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]
Message-ID: <87ldnfv46n.fsf@trenco.lwn.net>
Date: Tue, 19 Aug 2025 07:20:16 -0600
From: Jonathan Corbet <corbet@....net>
To: Sebastian Andrzej Siewior <bigeasy@...utronix.de>
Cc: linux-doc@...r.kernel.org, linux-kernel@...r.kernel.org,
linux-rt-devel@...ts.linux.dev, Boqun Feng <boqun.feng@...il.com>, Clark
Williams <clrkwllms@...nel.org>, Frederic Weisbecker
<frederic@...nel.org>, Ingo Molnar <mingo@...hat.com>, John Ogness
<john.ogness@...utronix.de>, Peter Zijlstra <peterz@...radead.org>, Steven
Rostedt <rostedt@...dmis.org>, Thomas Gleixner <tglx@...utronix.de>,
Valentin Schneider <vschneid@...hat.com>, Waiman Long
<longman@...hat.com>, Will Deacon <will@...nel.org>
Subject: Re: [PATCH v2 3/3] Documentation: Add real-time to core-api
Sebastian Andrzej Siewior <bigeasy@...utronix.de> writes:
> On 2025-08-18 10:16:41 [-0600], Jonathan Corbet wrote:
>> Sebastian Andrzej Siewior <bigeasy@...utronix.de> writes:
>>
>> One nit:
>>
>> > diff --git a/Documentation/core-api/real-time/differences.rst b/Documentation/core-api/real-time/differences.rst
>> > new file mode 100644
>> > index 0000000000000..50d994a31e11c
>> > --- /dev/null
>> > +++ b/Documentation/core-api/real-time/differences.rst
>> > @@ -0,0 +1,242 @@
>> > +.. SPDX-License-Identifier: GPL-2.0
>> > +
>> > +========================
>> > +Significant differences
>> > +========================
>>
>> That heading text will appear in various places, including in the
>> rendering of your new index.rst file. In such a setting, "significant
>> differences" doesn't give a lot of information. Something like "How
>> realtime kernels differ" would be better, IMO.
>>
>> Otherwise, this all looks good to me. Did you want me to pick it up, or
>> did you have another path in mind for this work?
>
> Right now this is it. Do you update the text above as suggested or do
> you want me to resend it?
I can apply it and make that tweak if you like, yes, no need to resend
for that.
Thanks,
jon
Powered by blists - more mailing lists