Re: [PATCH v2 3/3] Documentation: Add real-time to core-api

From: Jonathan Corbet
Date: Tue Aug 19 2025 - 09:22:36 EST


Sebastian Andrzej Siewior <bigeasy@xxxxxxxxxxxxx> writes:

> On 2025-08-18 10:16:41 [-0600], Jonathan Corbet wrote:
>> Sebastian Andrzej Siewior <bigeasy@xxxxxxxxxxxxx> 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