Re: [PATCH] Documentation: kernel-hacking: minor edits for style

From: Jonathan Corbet
Date: Tue Apr 05 2022 - 17:10:38 EST


Konstantin Ryabitsev <konstantin@xxxxxxxxxxxxxxxxxxx> writes:

> Rusty's kernel-hacking guides provide important information, however
> they are written in a narrative style that some readers may interpret as
> off-putting. Since the goal is to make kernel documentation accessible
> to as many new developers as possible, it's best to avoid the turns of
> phrase that require a specific cultural context to properly understand.
>
> Signed-off-by: Konstantin Ryabitsev <konstantin@xxxxxxxxxxxxxxxxxxx>
> ---
> Documentation/kernel-hacking/hacking.rst | 36 ++++++++++++------------
> Documentation/kernel-hacking/locking.rst | 5 +---
> 2 files changed, 19 insertions(+), 22 deletions(-)

*Sigh*...it's kind of sad to see the character of Rusty's writing being
chipped away over time; this isn't the first sanitization patch applied
to this file. It certainly needs a lot more work than this to match
current practice. Oh well, I've applied it, thanks.

jon