Skip to contentSkip to conversation

Documentation: management-style: Correct "know" past participle

PATCH In review Bagas Sanjaya 6 participants 10 messages Aug 26, 2025

Subsystems (2)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Documentation: management-style: Correct "know" past participle

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.

---
 Documentation/process/management-style.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
Documentation/process/management-style.rst +2 -2
index dfbc69bf49d435..1381b253b19ef4 100644
@@ -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

Signature · 1 line
An old man doll... just what I always wanted! - Clara
maintainer
#1 lore raw
Quoted 16 lines · Bagas Sanjaya

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.

---
 Documentation/process/management-style.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
Documentation/process/management-style.rst +0 -0
index dfbc69bf49d435..1381b253b19ef4 100644

Documentation/process/management-style.rst actually true. · line 46

Quoted 6 lines
Documentation/process/management-style.rst +1 -1
@@ -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

#2 lore raw
Quoted 5 lines · Jonathan Corbet
Quoted 5 lines
Documentation/process/management-style.rst +0 -0
index dfbc69bf49d435..1381b253b19ef4 100644
@@ -42,7 +42,7 @@ actually true.
Quoted 9 lines

Documentation/process/management-style.rst actually true. · line 46

Quoted 6 lines
Documentation/process/management-style.rst +1 -1
  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.

Signature · 1 line
An old man doll... just what I always wanted! - Clara
#3 lore raw

Hi Bagas,

Quoted 17 lines · On Tue, 26 Aug 2025 14:40:08 +0700 Bagas Sanjaya <[email protected]> wrote:
Quoted 5 lines · Jonathan Corbet
Quoted 5 lines
Documentation/process/management-style.rst +0 -0
index dfbc69bf49d435..1381b253b19ef4 100644
@@ -42,7 +42,7 @@ actually true.
Quoted 9 lines

Documentation/process/management-style.rst actually true. · line 46

Quoted 6 lines
Documentation/process/management-style.rst +1 -1
  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 ... ?

Quoted 2 lines

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

Signature · 2 lines
Cheers,
Stephen Rothwell
#4 lore raw
In reply to Jonathan Corbet
Quoted 11 lines · Jonathan Corbet
Quoted 11 lines

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.

---
 Documentation/process/management-style.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
Quoted 13 lines

Documentation/process/management-style.rst actually true. · line 46

Quoted 11 lines
Documentation/process/management-style.rst +1 -1
index dfbc69bf49d435..1381b253b19ef4 100644
@@ -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

maintainer
#5 lore raw
Quoted 10 lines · Konstantin Ryabitsev

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

#6 lore raw
In reply to Konstantin Ryabitsev
Quoted 10 lines · Konstantin Ryabitsev

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!

Signature · 1 line
An old man doll... just what I always wanted! - Clara
reviewer
#7 lore raw
In reply to Bagas Sanjaya
Quoted 6 lines · Bagas Sanjaya

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

Quoted 29 lines
---
 Documentation/process/management-style.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)
Documentation/process/management-style.rst +2 -2
index dfbc69bf49d435..1381b253b19ef4 100644
@@ -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

Signature · 1 line
~Randy
#8 lore raw
Quoted 7 lines · Randy Dunlap
Quoted 4 lines · Bagas Sanjaya

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.

Quoted 8 lines
Quoted 2 lines

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

Signature · 1 line
An old man doll... just what I always wanted! - Clara
#9 lore raw
In reply to Bagas Sanjaya
Quoted 1 line · Bagas Sanjaya

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.

Quoted 2 lines
Documentation/process/management-style.rst +1 -1
-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