From: Jonathan Corbet <corbet@lwn.net>
To: Sebastian Andrzej Siewior <bigeasy@linutronix.de>
Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org,
linux-rt-devel@lists.linux.dev, Boqun Feng <boqun.feng@gmail.com>,
Clark Williams <clrkwllms@kernel.org>,
Frederic Weisbecker <frederic@kernel.org>,
Ingo Molnar <mingo@redhat.com>,
John Ogness <john.ogness@linutronix.de>,
Peter Zijlstra <peterz@infradead.org>,
Steven Rostedt <rostedt@goodmis.org>,
Thomas Gleixner <tglx@linutronix.de>,
Valentin Schneider <vschneid@redhat.com>,
Waiman Long <longman@redhat.com>, Will Deacon <will@kernel.org>
Subject: Re: [PATCH v2 3/3] Documentation: Add real-time to core-api
Date: Tue, 19 Aug 2025 07:20:16 -0600 [thread overview]
Message-ID: <87ldnfv46n.fsf@trenco.lwn.net> (raw)
In-Reply-To: <20250819080358.H9R_64I7@linutronix.de>
Sebastian Andrzej Siewior <bigeasy@linutronix.de> writes:
> On 2025-08-18 10:16:41 [-0600], Jonathan Corbet wrote:
>> Sebastian Andrzej Siewior <bigeasy@linutronix.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
next prev parent reply other threads:[~2025-08-19 13:20 UTC|newest]
Thread overview: 13+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-08-15 9:38 [PATCH v2 0/3] Documentation: Add real-time bits Sebastian Andrzej Siewior
2025-08-15 9:38 ` [PATCH v2 1/3] Documentation: seqlock: Add a SPDX license identifier Sebastian Andrzej Siewior
2025-08-15 9:38 ` [PATCH v2 2/3] Documentation: locking: Add local_lock_nested_bh() to locktypes Sebastian Andrzej Siewior
2025-08-18 18:06 ` Waiman Long
2025-08-19 10:00 ` Sebastian Andrzej Siewior
2025-08-19 17:38 ` Waiman Long
2025-08-15 9:38 ` [PATCH v2 3/3] Documentation: Add real-time to core-api Sebastian Andrzej Siewior
2025-08-18 16:16 ` Jonathan Corbet
2025-08-19 8:03 ` Sebastian Andrzej Siewior
2025-08-19 13:20 ` Jonathan Corbet [this message]
2025-08-19 13:28 ` Sebastian Andrzej Siewior
2025-08-21 18:55 ` Jonathan Corbet
2025-08-22 7:08 ` Sebastian Andrzej Siewior
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87ldnfv46n.fsf@trenco.lwn.net \
--to=corbet@lwn.net \
--cc=bigeasy@linutronix.de \
--cc=boqun.feng@gmail.com \
--cc=clrkwllms@kernel.org \
--cc=frederic@kernel.org \
--cc=john.ogness@linutronix.de \
--cc=linux-doc@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=linux-rt-devel@lists.linux.dev \
--cc=longman@redhat.com \
--cc=mingo@redhat.com \
--cc=peterz@infradead.org \
--cc=rostedt@goodmis.org \
--cc=tglx@linutronix.de \
--cc=vschneid@redhat.com \
--cc=will@kernel.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.