git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: Felipe Contreras <felipe.contreras@gmail.com>
To: "Varun Varada" <varuncvarada@gmail.com>,
	"Michal Suchánek" <msuchanek@suse.de>
Cc: Felipe Contreras <felipe.contreras@gmail.com>, git@vger.kernel.org
Subject: Re: [PATCH] doc: replace jargon word "impact" with "effect"/"affect"
Date: Tue, 11 May 2021 22:43:38 -0500	[thread overview]
Message-ID: <609b4eea1088a_678ff208ba@natae.notmuch> (raw)
In-Reply-To: <CAD2i4DALKgw2wG6QGs-oQhAHnS3AG1j1BSq2bxjPojVOtw+WjA@mail.gmail.com>

Varun Varada wrote:

> Re: your point about me not pointing out specific examples: the
> command output for detached HEAD state reads "you can discard any
> commits you make in this state without impacting any branches by
> switching back to a branch". I'm incredibly passionate about this
> example. Here, the user is left to think, "wait...so this will not
> impact (significantly affect) any branches, but will it affect them?
> As in, are there side effects that I should be aware of? Where do I go
> to find out what they are?" All of this mental energy is completely
> unnecessary. Mind you, this is regarding discarding commits, which is
> a destructive action.

Completely agree.

I'm not a native speaker of English, but nowadays I use English more
than any other language, and when I read *impact* I read alarm bells.

First I'm reminded of "brace for impact", which something nobody should
take lightly (native speaker or not), and when I search for "impact" on
IMDB the first result I find is Deep Impact [1]. Not something bland.
Maybe my understanding of the word has been tainted by my experience,
sure...

But I'm still waiting for anybody to explain what's wrong with "affect".

> > > But why bother? The word "affect" is a much superior choice.
> >
> > Why bother with a chenge at all?
> 
> It seems like you already previously agreed with the premise that the
> word means "a significant effect" or "to significantly affect". I
> understand and appreciate your thoroughness to scrutinize changes to
> the repo, but I'm frankly surprised that such a small change is
> attracting such fierce debate. This is meant to be a change that is
> probably one of the easiest ones to decide on: it only consists of
> one-word changes that don't change functionality, yet undeniably
> reduce confusion.

When I started contributing to the git project more than 10 years ago I
noticed precisely the same thing.

It is a paradox called "the bikeshedding effect". When you contribute a
complex and convoluted change it's easier to get it in because few people
can object (as few people can understand it). But when you contribute a
change as simple as changing the color of something, then *everyone* can
opine (literally).

That's why the simplest changes tend to be the most difficult.

Additionally in my opinion the git project has a language problem, but
that's a separate subject.

> Re: your previous point about linguistic authorities: yes, there is no
> authority on usage, but therein lies my point. This doesn't even need
> to rise to the domain of usage, because it is squarely within the
> realm of semantics. Words mean something, and we all use dictionaries
> to learn about / confirm those meanings. Insofar as all the major
> dictionaries cite the word as "a significant effect" / "to affect
> significantly", that semantic concept doesn't belong in the cases
> where I've made changes. And if it does, then those need to be
> clarified (because that's where the real confusion/ambiguity is).
> I.e., it's not "why is not every case a significant effect?", but "why
> are some cases a significant effect?"

I often find it's easier to flip the problem around (from Karl Popper's
falsification principle).

It should not be your duty to prove that all swans are white (which is
impossible), it's the duty of the skeptics to prove that a single swan
is black.

I haven't seen a single person in this thread pointing out what's wrong
with "affect".

Cheers.

[1] https://www.imdb.com/title/tt0120647/

-- 
Felipe Contreras

  reply	other threads:[~2021-05-12  3:43 UTC|newest]

Thread overview: 68+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2021-04-05 21:48 [PATCH] doc: replace jargon word "impact" with "effect"/"affect" Varun Varada
2021-04-06  9:24 ` Michal Suchánek
2021-04-06 19:36   ` Varun Varada
2021-04-06 23:01     ` Jeff King
2021-04-07  0:06       ` Varun Varada
2021-04-28  0:39         ` Varun Varada
2021-04-28  8:58           ` Michal Suchánek
2021-04-28 18:15             ` Varun Varada
2021-04-28 18:49               ` Michal Suchánek
2021-04-30  1:51                 ` Varun Varada
2021-04-30  7:59                   ` Michal Suchánek
2021-05-10 17:19                     ` Varun Varada
2021-05-10 17:35                       ` Michal Suchánek
2021-05-10 18:37                         ` Varun Varada
2021-05-11 10:43                           ` Michal Suchánek
2021-05-11 13:22                             ` Junio C Hamano
2021-05-12  3:02                               ` Felipe Contreras
2021-05-12  2:59                             ` Felipe Contreras
2021-05-12  2:48                         ` Felipe Contreras
2021-05-12  2:38                 ` Felipe Contreras
2021-05-12  2:34             ` Felipe Contreras
2021-05-12  2:24       ` Felipe Contreras
2021-05-11 19:59     ` Felipe Contreras
2021-05-11 20:25       ` Michal Suchánek
2021-05-11 21:38         ` Varun Varada
2021-05-12  3:43           ` Felipe Contreras [this message]
2021-05-12  4:09             ` Michal Suchánek
2021-05-12  5:13               ` Felipe Contreras
2021-05-12  6:47                 ` Michal Suchánek
2021-05-12  9:06                   ` Felipe Contreras
2021-05-12 10:08                     ` Michal Suchánek
2021-05-12 10:33                       ` Michal Suchánek
2021-05-12 11:05                       ` Felipe Contreras
2021-05-12 11:20                         ` Michal Suchánek
2021-05-12 11:45                           ` Robert P. J. Day
2021-05-12 15:19                             ` Kerry, Richard
2021-05-12 16:47                   ` Varun Varada
2021-05-12 17:01                     ` Michal Suchánek
2021-05-12 17:32                       ` Felipe Contreras
2021-05-12 18:04                         ` Michal Suchánek
2021-05-12 19:42                           ` Felipe Contreras
2021-05-13  7:46                             ` Michal Suchánek
2021-05-13  8:28                               ` Felipe Contreras
2021-05-13  8:55                               ` Robert Coup
2021-05-13  9:48                                 ` Michal Suchánek
2021-05-13  9:59                                   ` Felipe Contreras
2021-05-26 23:49                                   ` Varun Varada
2021-05-27 11:46                                     ` Michal Suchánek
2021-05-27 14:08                                       ` Felipe Contreras
2021-05-27 14:35                                         ` Michal Suchánek
2021-05-27 16:43                                           ` Felipe Contreras
2021-06-12 23:13                                           ` Varun Varada
2021-06-13 11:40                                             ` Michal Suchánek
2021-06-13 14:06                                               ` Felipe Contreras
2021-06-13 16:28                                                 ` Michal Suchánek
2021-06-13 17:12                                                   ` Felipe Contreras
2021-05-12 22:52                       ` Varun Varada
2021-05-13  6:19                         ` Felipe Contreras
2021-05-12  3:21         ` Felipe Contreras
2021-05-11 19:21   ` Felipe Contreras
2021-05-11 19:57     ` Michal Suchánek
2021-05-12  3:09       ` Felipe Contreras
2021-05-12  4:11         ` Michal Suchánek
2021-05-12  5:22           ` Felipe Contreras
2021-05-12 16:39           ` Varun Varada
2021-05-13 10:40 ` Philip Oakley
2021-05-26 23:52   ` Varun Varada
2021-05-27 11:20     ` Philip Oakley

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

  List information: http://vger.kernel.org/majordomo-info.html

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=609b4eea1088a_678ff208ba@natae.notmuch \
    --to=felipe.contreras@gmail.com \
    --cc=git@vger.kernel.org \
    --cc=msuchanek@suse.de \
    --cc=varuncvarada@gmail.com \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).