Re: [PATCH] doc: replace jargon word "impact" with "effect"/"affect"

From: Felipe Contreras <felipe.contreras@gmail.com>
Date: May 11, 2021, 19:21 UTC
Message-ID: <609ad9473d535_6011e2082@natae.notmuch>
In-Reply-To: <20210406092440.GZ6564@kitsune.suse.cz>

Michal Suchánek wrote:

Show 12 quoted lines

> On Mon, Apr 05, 2021 at 04:48:58PM -0500, Varun Varada wrote:
> > There are a bunch of places in the code/docs which use the word "impact"
> > incorrectly. This is especially true of places where it says "will not
> > impact", which suggests that it might have an effect, albeit not as
> > strong of a one. This commit replaces all of these with their
> > appropriate alternative so that the docs not only does not use jargon,
> > but are also unambiguous.
> 
> Hello,
> 
> while using "will not impact" in an incorrect or unclear way may be a
> problem the word "impact" in itself is not "jargon".

From Merriam-Webster:

  jargon _noun_
  : obscure and often pretentious language marked by circumlocutions and
    long words

> If you are concerned about correctness and clarity of the documentation please
> avoid spreading misinformation.

Under certain definition of "jaron" Varun's statement would be incorrect, but not under all definitions. If you use the definition I stated above, "impact" can be considered jargon, because it's a bit obscure language.

Ultimately it doesn't matter if it's jargon or not, only that we have better alternatives.

> Thanks
> 
> Michal

Michal, can you please remove quoted lines you are not replying to? Those 762 extra lines make it harder for some of us to read the thread. We don't have email guidelines, but if we did, that certain would be one of the points.

Cheers.

-- 
Felipe Contreras