Re: [PATCH] Documentation: polish Executive Summary and Intro in stable-api-nonsense.rst

[Greg KH <greg@kroah.com>]

On Fri, Feb 20, 2026 at 11:51:28AM -0800, Randy Dunlap wrote:
> 
> 
> On 2/20/26 5:29 AM, Ariful Islam Shoikot wrote:
> > Signed-off-by: Ariful Islam Shoikot <islamarifulshoikat@gmail.com>
> > ---
> >  Documentation/process/stable-api-nonsense.rst | 16 ++++++++--------
> >  1 file changed, 8 insertions(+), 8 deletions(-)
> > 
> > diff --git a/Documentation/process/stable-api-nonsense.rst b/Documentation/process/stable-api-nonsense.rst
> > index a9625ab1fdc2..120c10ec2ab1 100644
> > --- a/Documentation/process/stable-api-nonsense.rst
> > +++ b/Documentation/process/stable-api-nonsense.rst
> > @@ -17,7 +17,7 @@ kernel interface, nor does it have a stable kernel interface**.
> >  
> >    The kernel to userspace interface is the one that application programs use,
> >    the syscall interface.  That interface is **very** stable over time, and
> > -  will not break.  I have old programs that were built on a pre 0.9something
> > +  will not break.  I have old programs that were built on a pre 0.9 something
> 
> The original is better IMO.
> Maybe (!) there could be hyphenated:  pre-0.9-something

I'm pretty the original here is correct, we didn't use a '-' after 0.9,
right?

> >    kernel that still work just fine on the latest 2.6 kernel release.
> >    That interface is the one that users and application programmers can count
> >    on being stable.
> > @@ -25,13 +25,13 @@ kernel interface, nor does it have a stable kernel interface**.
> >  
> >  Executive Summary
> >  -----------------
> > -You think you want a stable kernel interface, but you really do not, and
> > -you don't even know it.  What you want is a stable running driver, and
> > -you get that only if your driver is in the main kernel tree.  You also
> > -get lots of other good benefits if your driver is in the main kernel
> > -tree, all of which has made Linux into such a strong, stable, and mature
> > -operating system which is the reason you are using it in the first
> > -place.
> > +
> > +You might think you want a stable kernel interface, but you really do not - and
> > +you may not even realize it. What you truly want is a stable, running driver,
> > +which you get only if your driver is in the main kernel tree. Being in the main
> > +kernel tree also provides many additional benefits, all of which have helped 
> > +make Linux a strong, stable, and mature operating system - the very reason you 
> > +are using it today.
> 
> This adds 2 lines with trailing spaces.
> I thought that checkpatch would catch that - so did you run checkpatch on
> this patch?
> 
> The wordsmithing is a slight improvement IMO, especially  "has" ->  "have".

Let's not wordsmith this, it's been around for forever as-is and the
content is the same, otherwise every grammer-bot is going to want to
tweak it slightly different :)

thanks,

greg k-h