From: Sebastian Andrzej Siewior <bigeasy@linutronix.de>
To: Jonathan Corbet <corbet@lwn.net>
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 10:03:58 +0200 [thread overview]
Message-ID: <20250819080358.H9R_64I7@linutronix.de> (raw)
In-Reply-To: <87seho8v12.fsf@trenco.lwn.net>
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?
> Thanks,
>
> jon
Sebastian
next prev parent reply other threads:[~2025-08-19 8:04 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 [this message]
2025-08-19 13:20 ` Jonathan Corbet
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=20250819080358.H9R_64I7@linutronix.de \
--to=bigeasy@linutronix.de \
--cc=boqun.feng@gmail.com \
--cc=clrkwllms@kernel.org \
--cc=corbet@lwn.net \
--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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).