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

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

[Ariful Islam Shoikot]

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
   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.
 
 
 Intro
-- 
2.43.0

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

[Randy Dunlap]

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

>    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".


-- 
~Randy

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

[Greg KH]

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

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

[Greg KH]

On Fri, Feb 20, 2026 at 07:29:09PM +0600, Ariful Islam Shoikot wrote:
> Signed-off-by: Ariful Islam Shoikot <islamarifulshoikat@gmail.com>
> ---

For obvious reasons I can't take patches without any changelog text at
all, sorry.

thanks,

greg k-h