linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] Documentation: management-style: Correct "know" past participle
@ 2025-08-26  0:34 Bagas Sanjaya
  2025-08-26  4:47 ` Jonathan Corbet
                   ` (2 more replies)
  0 siblings, 3 replies; 10+ messages in thread
From: Bagas Sanjaya @ 2025-08-26  0:34 UTC (permalink / raw)
  To: Linux Kernel Mailing List, Linux Documentation,
	Linux Kernel Workflows
  Cc: Jonathan Corbet, Bagas Sanjaya, Fox Foster, Federico Vaga,
	Jonathan Neuschäfer, Randy Dunlap

Management style docs writes on people under a manager, where they know
the details better than the manager himself, in past perfect tense. Yet,
"know" is in infinitive form instead.

Correct the verb form.

Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
---
 Documentation/process/management-style.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/Documentation/process/management-style.rst b/Documentation/process/management-style.rst
index dfbc69bf49d435..1381b253b19ef4 100644
--- a/Documentation/process/management-style.rst
+++ b/Documentation/process/management-style.rst
@@ -42,7 +42,7 @@ 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 had better known the details than you, so if they come to
 you for a technical decision, you're screwed.  You're clearly not
 competent to make that decision for them.
 
@@ -115,7 +115,7 @@ sure as hell shouldn't encourage them by promising them that what they
 work on will be included.  Make them at least think twice before they
 embark on a big endeavor.
 
-Remember: they'd better know more about the details than you do, and
+Remember: they'd better known more about the details than you do, and
 they usually already think they have the answer to everything.  The best
 thing you can do as a manager is not to instill confidence, but rather a
 healthy dose of critical thinking on what they do.

base-commit: ee9a6691935490dc39605882b41b9452844d5e4e
-- 
An old man doll... just what I always wanted! - Clara


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

* Re: [PATCH] Documentation: management-style: Correct "know" past participle
  2025-08-26  0:34 [PATCH] Documentation: management-style: Correct "know" past participle Bagas Sanjaya
@ 2025-08-26  4:47 ` Jonathan Corbet
  2025-08-26  7:40   ` Bagas Sanjaya
  2025-08-26 14:46   ` Konstantin Ryabitsev
  2025-08-26  6:54 ` Randy Dunlap
  2025-08-26 11:53 ` Matthew Wilcox
  2 siblings, 2 replies; 10+ messages in thread
From: Jonathan Corbet @ 2025-08-26  4:47 UTC (permalink / raw)
  To: Bagas Sanjaya, Linux Kernel Mailing List, Linux Documentation,
	Linux Kernel Workflows
  Cc: Bagas Sanjaya, Fox Foster, Federico Vaga,
	Jonathan Neuschäfer, Randy Dunlap

Bagas Sanjaya <bagasdotme@gmail.com> writes:

> Management style docs writes on people under a manager, where they know
> the details better than the manager himself, in past perfect tense. Yet,
> "know" is in infinitive form instead.
>
> Correct the verb form.
>
> Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
> ---
>  Documentation/process/management-style.rst | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
>
> diff --git a/Documentation/process/management-style.rst b/Documentation/process/management-style.rst
> index dfbc69bf49d435..1381b253b19ef4 100644
> --- a/Documentation/process/management-style.rst
> +++ b/Documentation/process/management-style.rst
> @@ -42,7 +42,7 @@ 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 had better known the details than you, so if they come to
>  you for a technical decision, you're screwed.  You're clearly not

This seems actively wrong ... ?

jon

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

* Re: [PATCH] Documentation: management-style: Correct "know" past participle
  2025-08-26  0:34 [PATCH] Documentation: management-style: Correct "know" past participle Bagas Sanjaya
  2025-08-26  4:47 ` Jonathan Corbet
@ 2025-08-26  6:54 ` Randy Dunlap
  2025-08-26  7:42   ` Bagas Sanjaya
  2025-08-26 11:53 ` Matthew Wilcox
  2 siblings, 1 reply; 10+ messages in thread
From: Randy Dunlap @ 2025-08-26  6:54 UTC (permalink / raw)
  To: Bagas Sanjaya, Linux Kernel Mailing List, Linux Documentation,
	Linux Kernel Workflows
  Cc: Jonathan Corbet, Fox Foster, Federico Vaga,
	Jonathan Neuschäfer



On 8/25/25 5:34 PM, Bagas Sanjaya wrote:
> Management style docs writes on people under a manager, where they know
> the details better than the manager himself, in past perfect tense. Yet,
> "know" is in infinitive form instead.
> 
> Correct the verb form.
> 

Hi Bagas,

I don't know about the patch description/argument/justification,
but the wording makes no sense to me...

> Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
> ---
>  Documentation/process/management-style.rst | 4 ++--
>  1 file changed, 2 insertions(+), 2 deletions(-)
> 
> diff --git a/Documentation/process/management-style.rst b/Documentation/process/management-style.rst
> index dfbc69bf49d435..1381b253b19ef4 100644
> --- a/Documentation/process/management-style.rst
> +++ b/Documentation/process/management-style.rst
> @@ -42,7 +42,7 @@ 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 had better known the details than you, so if they come to
>  you for a technical decision, you're screwed.  You're clearly not
>  competent to make that decision for them.
>  
> @@ -115,7 +115,7 @@ sure as hell shouldn't encourage them by promising them that what they
>  work on will be included.  Make them at least think twice before they
>  embark on a big endeavor.
>  
> -Remember: they'd better know more about the details than you do, and
> +Remember: they'd better known more about the details than you do, and
>  they usually already think they have the answer to everything.  The best
>  thing you can do as a manager is not to instill confidence, but rather a
>  healthy dose of critical thinking on what they do.
> 
> base-commit: ee9a6691935490dc39605882b41b9452844d5e4e

-- 
~Randy


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

* Re: [PATCH] Documentation: management-style: Correct "know" past participle
  2025-08-26  4:47 ` Jonathan Corbet
@ 2025-08-26  7:40   ` Bagas Sanjaya
  2025-08-26  8:25     ` Stephen Rothwell
  2025-08-26 14:46   ` Konstantin Ryabitsev
  1 sibling, 1 reply; 10+ messages in thread
From: Bagas Sanjaya @ 2025-08-26  7:40 UTC (permalink / raw)
  To: Jonathan Corbet, Linux Kernel Mailing List, Linux Documentation,
	Linux Kernel Workflows
  Cc: Fox Foster, Federico Vaga, Jonathan Neuschäfer, Randy Dunlap

On 8/26/25 11:47, Jonathan Corbet wrote:
>> diff --git a/Documentation/process/management-style.rst b/Documentation/process/management-style.rst
>> index dfbc69bf49d435..1381b253b19ef4 100644
>> --- a/Documentation/process/management-style.rst
>> +++ b/Documentation/process/management-style.rst
>> @@ -42,7 +42,7 @@ 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 had better known the details than you, so if they come to
>>   you for a technical decision, you're screwed.  You're clearly not
> 
> This seems actively wrong ... ?
> 

What I thought on the original wording was that the people (i.e. 
developers) know the (technical) details better than their manager.
And yeah, "better" was duplicated.

Thanks.

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

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

* Re: [PATCH] Documentation: management-style: Correct "know" past participle
  2025-08-26  6:54 ` Randy Dunlap
@ 2025-08-26  7:42   ` Bagas Sanjaya
  0 siblings, 0 replies; 10+ messages in thread
From: Bagas Sanjaya @ 2025-08-26  7:42 UTC (permalink / raw)
  To: Randy Dunlap, Linux Kernel Mailing List, Linux Documentation,
	Linux Kernel Workflows
  Cc: Jonathan Corbet, Fox Foster, Federico Vaga,
	Jonathan Neuschäfer

On 8/26/25 13:54, Randy Dunlap wrote:
> 
> 
> On 8/25/25 5:34 PM, Bagas Sanjaya wrote:
>> Management style docs writes on people under a manager, where they know
>> the details better than the manager himself, in past perfect tense. Yet,
>> "know" is in infinitive form instead.
>>
>> Correct the verb form.
>>
> 
> Hi Bagas,
> 
> I don't know about the patch description/argument/justification,
> but the wording makes no sense to me...
> 

Do you mean the original or the patched? Should I left the former as-is?

Confused...

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

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

* Re: [PATCH] Documentation: management-style: Correct "know" past participle
  2025-08-26  7:40   ` Bagas Sanjaya
@ 2025-08-26  8:25     ` Stephen Rothwell
  0 siblings, 0 replies; 10+ messages in thread
From: Stephen Rothwell @ 2025-08-26  8:25 UTC (permalink / raw)
  To: Bagas Sanjaya
  Cc: Jonathan Corbet, Linux Kernel Mailing List, Linux Documentation,
	Linux Kernel Workflows, Fox Foster, Federico Vaga,
	Jonathan Neuschäfer, Randy Dunlap

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

Hi Bagas,

On Tue, 26 Aug 2025 14:40:08 +0700 Bagas Sanjaya <bagasdotme@gmail.com> wrote:
>
> On 8/26/25 11:47, Jonathan Corbet wrote:
> >> diff --git a/Documentation/process/management-style.rst b/Documentation/process/management-style.rst
> >> index dfbc69bf49d435..1381b253b19ef4 100644
> >> --- a/Documentation/process/management-style.rst
> >> +++ b/Documentation/process/management-style.rst
> >> @@ -42,7 +42,7 @@ 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 had better known the details than you, so if they come to
> >>   you for a technical decision, you're screwed.  You're clearly not  
> > 
> > This seems actively wrong ... ?
> >   
> 
> What I thought on the original wording was that the people (i.e. developers) know the (technical) details better than their manager.
> And yeah, "better" was duplicated.

One way to make this clearer would be:

 ... The people you
manage should know the details better than you ...

-- 
Cheers,
Stephen Rothwell

[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 488 bytes --]

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

* Re: [PATCH] Documentation: management-style: Correct "know" past participle
  2025-08-26  0:34 [PATCH] Documentation: management-style: Correct "know" past participle Bagas Sanjaya
  2025-08-26  4:47 ` Jonathan Corbet
  2025-08-26  6:54 ` Randy Dunlap
@ 2025-08-26 11:53 ` Matthew Wilcox
  2 siblings, 0 replies; 10+ messages in thread
From: Matthew Wilcox @ 2025-08-26 11:53 UTC (permalink / raw)
  To: Bagas Sanjaya
  Cc: Linux Kernel Mailing List, Linux Documentation,
	Linux Kernel Workflows, Jonathan Corbet, Fox Foster,
	Federico Vaga, Jonathan Neuschäfer, Randy Dunlap

On Tue, Aug 26, 2025 at 07:34:38AM +0700, Bagas Sanjaya wrote:
> Correct the verb form.

No, this is wrong.  I don't know the linguistic terms, but as a native
English speaker, I know this is wrong.

> -manage had better know the details better than you, so if they come to
> +manage had better known the details than you, so if they come to

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

* Re: [PATCH] Documentation: management-style: Correct "know" past participle
  2025-08-26  4:47 ` Jonathan Corbet
  2025-08-26  7:40   ` Bagas Sanjaya
@ 2025-08-26 14:46   ` Konstantin Ryabitsev
  2025-08-26 15:22     ` Jonathan Corbet
  2025-08-26 23:54     ` Bagas Sanjaya
  1 sibling, 2 replies; 10+ messages in thread
From: Konstantin Ryabitsev @ 2025-08-26 14:46 UTC (permalink / raw)
  To: Jonathan Corbet
  Cc: Bagas Sanjaya, Linux Kernel Mailing List, Linux Documentation,
	Linux Kernel Workflows, Fox Foster, Federico Vaga,
	Jonathan Neuschäfer, Randy Dunlap

On Mon, Aug 25, 2025 at 10:47:28PM -0600, Jonathan Corbet wrote:
> > Management style docs writes on people under a manager, where they know
> > the details better than the manager himself, in past perfect tense. Yet,
> > "know" is in infinitive form instead.
> >
> > Correct the verb form.
> >
> > Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
> > ---
> >  Documentation/process/management-style.rst | 4 ++--
> >  1 file changed, 2 insertions(+), 2 deletions(-)
> >
> > diff --git a/Documentation/process/management-style.rst b/Documentation/process/management-style.rst
> > index dfbc69bf49d435..1381b253b19ef4 100644
> > --- a/Documentation/process/management-style.rst
> > +++ b/Documentation/process/management-style.rst
> > @@ -42,7 +42,7 @@ 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 had better known the details than you, so if they come to
> >  you for a technical decision, you're screwed.  You're clearly not
> 
> This seems actively wrong ... ?

I do believe this is a clear indicator that the whole sentence needs to be
reworded:

    ... if somebody tells you to "choose (a) or (b), we really need you to
    decide on this," you're in trouble as a manager. The people you manage
    most likely know the details better than you, so if they come to you for
    a technical decision, ...

This change would detract from the... unique... style of this document, but
would hopefully be less confusing to non-native speakers.

-K

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

* Re: [PATCH] Documentation: management-style: Correct "know" past participle
  2025-08-26 14:46   ` Konstantin Ryabitsev
@ 2025-08-26 15:22     ` Jonathan Corbet
  2025-08-26 23:54     ` Bagas Sanjaya
  1 sibling, 0 replies; 10+ messages in thread
From: Jonathan Corbet @ 2025-08-26 15:22 UTC (permalink / raw)
  To: Konstantin Ryabitsev
  Cc: Bagas Sanjaya, Linux Kernel Mailing List, Linux Documentation,
	Linux Kernel Workflows, Fox Foster, Federico Vaga,
	Jonathan Neuschäfer, Randy Dunlap

Konstantin Ryabitsev <konstantin@linuxfoundation.org> writes:

> I do believe this is a clear indicator that the whole sentence needs to be
> reworded:
>
>     ... if somebody tells you to "choose (a) or (b), we really need you to
>     decide on this," you're in trouble as a manager. The people you manage
>     most likely know the details better than you, so if they come to you for
>     a technical decision, ...
>
> This change would detract from the... unique... style of this document, but
> would hopefully be less confusing to non-native speakers.

There has been talk in some circles about trying to update this
... unique ... style to more contemporary standards.  Maybe it's time to
see if that can be given a bit of encouragement.

Thanks,

jon

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

* Re: [PATCH] Documentation: management-style: Correct "know" past participle
  2025-08-26 14:46   ` Konstantin Ryabitsev
  2025-08-26 15:22     ` Jonathan Corbet
@ 2025-08-26 23:54     ` Bagas Sanjaya
  1 sibling, 0 replies; 10+ messages in thread
From: Bagas Sanjaya @ 2025-08-26 23:54 UTC (permalink / raw)
  To: Konstantin Ryabitsev, Jonathan Corbet
  Cc: Linux Kernel Mailing List, Linux Documentation,
	Linux Kernel Workflows, Fox Foster, Federico Vaga,
	Jonathan Neuschäfer, Randy Dunlap

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

On Tue, Aug 26, 2025 at 10:46:50AM -0400, Konstantin Ryabitsev wrote:
> I do believe this is a clear indicator that the whole sentence needs to be
> reworded:
> 
>     ... if somebody tells you to "choose (a) or (b), we really need you to
>     decide on this," you're in trouble as a manager. The people you manage
>     most likely know the details better than you, so if they come to you for
>     a technical decision, ...
> 
> This change would detract from the... unique... style of this document, but
> would hopefully be less confusing to non-native speakers.

Thanks for the suggestion!

-- 
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] 10+ messages in thread

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

Thread overview: 10+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2025-08-26  0:34 [PATCH] Documentation: management-style: Correct "know" past participle Bagas Sanjaya
2025-08-26  4:47 ` Jonathan Corbet
2025-08-26  7:40   ` Bagas Sanjaya
2025-08-26  8:25     ` Stephen Rothwell
2025-08-26 14:46   ` Konstantin Ryabitsev
2025-08-26 15:22     ` Jonathan Corbet
2025-08-26 23:54     ` Bagas Sanjaya
2025-08-26  6:54 ` Randy Dunlap
2025-08-26  7:42   ` Bagas Sanjaya
2025-08-26 11:53 ` Matthew Wilcox

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