linux-doc.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] Documentation: process: Fix grammar errors in management-style.rst
@ 2025-08-24 18:50 I Viswanath
  2025-08-25  5:10 ` Jonathan Corbet
  0 siblings, 1 reply; 4+ messages in thread
From: I Viswanath @ 2025-08-24 18:50 UTC (permalink / raw)
  To: corbet; +Cc: workflows, linux-doc, skhan, linux-kernel-mentees, I Viswanath

Fix various grammatical errors in management-style.rst

Signed-off-by: I Viswanath <viswanathiyyappan@gmail.com>
---
 Documentation/process/management-style.rst | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/Documentation/process/management-style.rst b/Documentation/process/management-style.rst
index dfbc69bf49d4..4ae05a89950a 100644
--- a/Documentation/process/management-style.rst
+++ b/Documentation/process/management-style.rst
@@ -15,8 +15,8 @@ to do with reality.  It started as a lark, but that doesn't mean that it
 might not actually be true. You'll have to decide for yourself.
 
 Btw, when talking about "kernel manager", it's all about the technical
-lead persons, not the people who do traditional management inside
-companies.  If you sign purchase orders or you have any clue about the
+leads, not those who do traditional management inside
+companies.  If you sign purchase orders or have any clue about the
 budget of your group, you're almost certainly not a kernel manager.
 These suggestions may or may not apply to you.
 
@@ -42,9 +42,9 @@ actually true.
 The name of the game is to **avoid** having to make a decision.  In
 particular, if somebody tells you "choose (a) or (b), we really need you
 to decide on this", you're in trouble as a manager.  The people you
-manage had better know the details better than you, so if they come to
+manage better know the details better than you; if they come to
 you for a technical decision, you're screwed.  You're clearly not
-competent to make that decision for them.
+competent enough to make that decision for them.
 
 (Corollary:if the people you manage don't know the details better than
 you, you're also screwed, although for a totally different reason.
-- 
2.50.1


^ permalink raw reply related	[flat|nested] 4+ messages in thread

* Re: [PATCH] Documentation: process: Fix grammar errors in management-style.rst
  2025-08-24 18:50 [PATCH] Documentation: process: Fix grammar errors in management-style.rst I Viswanath
@ 2025-08-25  5:10 ` Jonathan Corbet
  2025-08-25 17:17   ` viswanath
  2025-08-26  0:00   ` Bagas Sanjaya
  0 siblings, 2 replies; 4+ messages in thread
From: Jonathan Corbet @ 2025-08-25  5:10 UTC (permalink / raw)
  To: I Viswanath
  Cc: workflows, linux-doc, skhan, linux-kernel-mentees, I Viswanath

I Viswanath <viswanathiyyappan@gmail.com> writes:

> Fix various grammatical errors in management-style.rst
>
> Signed-off-by: I Viswanath <viswanathiyyappan@gmail.com>

Thank you for working to improve our documentation...I don't think I can
apply this patch, though.

Your signoff should include your full name, please.

But more importantly...

> ---
>  Documentation/process/management-style.rst | 8 ++++----
>  1 file changed, 4 insertions(+), 4 deletions(-)
>
> diff --git a/Documentation/process/management-style.rst b/Documentation/process/management-style.rst
> index dfbc69bf49d4..4ae05a89950a 100644
> --- a/Documentation/process/management-style.rst
> +++ b/Documentation/process/management-style.rst
> @@ -15,8 +15,8 @@ to do with reality.  It started as a lark, but that doesn't mean that it
>  might not actually be true. You'll have to decide for yourself.
>  
>  Btw, when talking about "kernel manager", it's all about the technical
> -lead persons, not the people who do traditional management inside
> -companies.  If you sign purchase orders or you have any clue about the
> +leads, not those who do traditional management inside
> +companies.  If you sign purchase orders or have any clue about the

This change is OK, but what was there was OK too

>  budget of your group, you're almost certainly not a kernel manager.
>  These suggestions may or may not apply to you.
>  
> @@ -42,9 +42,9 @@ actually true.
>  The name of the game is to **avoid** having to make a decision.  In
>  particular, if somebody tells you "choose (a) or (b), we really need you
>  to decide on this", you're in trouble as a manager.  The people you
> -manage had better know the details better than you, so if they come to
> +manage better know the details better than you; if they come to

This one changes the meaning of the sentence

>  you for a technical decision, you're screwed.  You're clearly not
> -competent to make that decision for them.
> +competent enough to make that decision for them.

...and this one was fine as it was.

>  (Corollary:if the people you manage don't know the details better than
>  you, you're also screwed, although for a totally different reason.
> -- 

In general, this kind of playing with the wording for text that is not
actually wrong is not hugely helpful; I would encourage you to look
elsewhere for places to contribute to the documentation.

Thanks,

jon

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] Documentation: process: Fix grammar errors in management-style.rst
  2025-08-25  5:10 ` Jonathan Corbet
@ 2025-08-25 17:17   ` viswanath
  2025-08-26  0:00   ` Bagas Sanjaya
  1 sibling, 0 replies; 4+ messages in thread
From: viswanath @ 2025-08-25 17:17 UTC (permalink / raw)
  To: Jonathan Corbet; +Cc: workflows, linux-doc, skhan, linux-kernel-mentees

On Mon, 25 Aug 2025 at 10:40, Jonathan Corbet <corbet@lwn.net> wrote:
>
> I Viswanath <viswanathiyyappan@gmail.com> writes:
>
> > Fix various grammatical errors in management-style.rst
> >
> > Signed-off-by: I Viswanath <viswanathiyyappan@gmail.com>
>
> Thank you for working to improve our documentation...I don't think I can
> apply this patch, though.
>
> Your signoff should include your full name, please.
>
Just to clarify --- "I Viswanath" is my legal name as it appears on my
official documents.

> But more importantly...
>
> > ---
> >  Documentation/process/management-style.rst | 8 ++++----
> >  1 file changed, 4 insertions(+), 4 deletions(-)
> >
> > diff --git a/Documentation/process/management-style.rst b/Documentation/process/management-style.rst
> > index dfbc69bf49d4..4ae05a89950a 100644
> > --- a/Documentation/process/management-style.rst
> > +++ b/Documentation/process/management-style.rst
> > @@ -15,8 +15,8 @@ to do with reality.  It started as a lark, but that doesn't mean that it
> >  might not actually be true. You'll have to decide for yourself.
> >
> >  Btw, when talking about "kernel manager", it's all about the technical
> > -lead persons, not the people who do traditional management inside
> > -companies.  If you sign purchase orders or you have any clue about the
> > +leads, not those who do traditional management inside
> > +companies.  If you sign purchase orders or have any clue about the
>
> This change is OK, but what was there was OK too
Noted

>
> >  budget of your group, you're almost certainly not a kernel manager.
> >  These suggestions may or may not apply to you.
> >
> > @@ -42,9 +42,9 @@ actually true.
> >  The name of the game is to **avoid** having to make a decision.  In
> >  particular, if somebody tells you "choose (a) or (b), we really need you
> >  to decide on this", you're in trouble as a manager.  The people you
> > -manage had better know the details better than you, so if they come to
> > +manage better know the details better than you; if they come to
>
> This one changes the meaning of the sentence
Sorry for that.

>
> >  you for a technical decision, you're screwed.  You're clearly not
> > -competent to make that decision for them.
> > +competent enough to make that decision for them.
>
> ...and this one was fine as it was.
>
Noted

> >  (Corollary:if the people you manage don't know the details better than
> >  you, you're also screwed, although for a totally different reason.
> > --
>
> In general, this kind of playing with the wording for text that is not
> actually wrong is not hugely helpful; I would encourage you to look
> elsewhere for places to contribute to the documentation.

I see. Thanks for taking your time to reply to this.
>
> Thanks,
>
> jon

Thanks,
I Viswanath

^ permalink raw reply	[flat|nested] 4+ messages in thread

* Re: [PATCH] Documentation: process: Fix grammar errors in management-style.rst
  2025-08-25  5:10 ` Jonathan Corbet
  2025-08-25 17:17   ` viswanath
@ 2025-08-26  0:00   ` Bagas Sanjaya
  1 sibling, 0 replies; 4+ messages in thread
From: Bagas Sanjaya @ 2025-08-26  0:00 UTC (permalink / raw)
  To: Jonathan Corbet, I Viswanath
  Cc: workflows, linux-doc, skhan, linux-kernel-mentees

[-- Attachment #1: Type: text/plain, Size: 733 bytes --]

On Sun, Aug 24, 2025 at 11:10:29PM -0600, Jonathan Corbet wrote:
> > @@ -42,9 +42,9 @@ actually true.
> >  The name of the game is to **avoid** having to make a decision.  In
> >  particular, if somebody tells you "choose (a) or (b), we really need you
> >  to decide on this", you're in trouble as a manager.  The people you
> > -manage had better know the details better than you, so if they come to
> > +manage better know the details better than you; if they come to
> 
> This one changes the meaning of the sentence

I think the sentence means that people under a manager know the details
(i.e. intricacies) better than their manager himself.

Thanks.

-- 
An old man doll... just what I always wanted! - Clara

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]

^ permalink raw reply	[flat|nested] 4+ messages in thread

end of thread, other threads:[~2025-08-26  0:00 UTC | newest]

Thread overview: 4+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-08-24 18:50 [PATCH] Documentation: process: Fix grammar errors in management-style.rst I Viswanath
2025-08-25  5:10 ` Jonathan Corbet
2025-08-25 17:17   ` viswanath
2025-08-26  0:00   ` Bagas Sanjaya

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