Re: [PATCH v2 0/5] Documentation: process: Clean up grammar, tone,
From: Weijie Yuan
Date: Thu Sep 03 2026 - 13:44:35 EST
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". ;-)
Thanks.