Re: [PATCH v2 0/5] Documentation: process: Clean up grammar, tone,

From: Jonathan Corbet

Date: Thu Sep 03 2026 - 14:16:24 EST


Weijie Yuan <wy@xxxxxxxxx> writes:

> On Thu, Sep 03, 2026 at 03:54:54PM +0300, Laurent Pinchart wrote:
>> > On Wed, Sep 02, 2026 at 03:43:58PM +0700, Nguyen Duc Thinh wrote:
>> > > This patch series performs a thorough pass across several files
>> > > in the Linux kernel process documentation directory. The primary focus
>> > > is to improve readability and maintain a professional tone throughout
>> > > the guides for a global developer audience.
>> > >
>> > > Core changes include:
>> > > - Expanding conversational contractions (e.g., "don't" to "do not").
>> >
>> > Is this necessary? I'm not sure.
>>
>> It seems a bit pointless to me. Contractions will creep back in as
>> patches are merged. We would need e documentation editor in charge of
>> ensuring a consistent style, and I think the documentation maintainers
>> have far better things to do.
>
> Agreed. I think contractions are fine as they are. (?) And I do not see
> a need to expand them.
>
>> > > - Rectifying minor punctuation oversights and grammatical typos.
>> > > - Standardizing terminology formatting to elevate professional voice.
>
> For these two points, it's a little bit painful to find other types of
> modifications among numerous "which/that". ;-)

I have to agree with all of that; I don't see merging this series as it
is now. We have so many documentation problems, and this sort of churn
just does not address any of them.

Thanks,

jon