git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Junio C Hamano <gitster@pobox.com>
To: QueenJcloud <qjessa662@gmail.com>
Cc: git@vger.kernel.org,  christian.couder@gmail.com,
	usmanakinyemi202@gmail.com
Subject: Re: [PATCH] docs: simplify help sentence in MyFirstContribution.adoc
Date: Thu, 23 Oct 2025 10:19:54 -0700	[thread overview]
Message-ID: <xmqqjz0lv8lh.fsf@gitster.g> (raw)
In-Reply-To: <20251023124801.334-1-qjessa662@gmail.com> (QueenJcloud's message of "Thu, 23 Oct 2025 13:48:01 +0100")

QueenJcloud <qjessa662@gmail.com> writes:

> This commit simplifies the help sentence in the MyFirstContribution
> document to make it shorter and clearer for new contributors.
>
> Signed-off-by: QueenJcloud <qjessa662@gmail.com>
> ---
>  Documentation/MyFirstContribution.adoc | 2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
>
> diff --git a/Documentation/MyFirstContribution.adoc b/Documentation/MyFirstContribution.adoc
> index 91c6296ffe..f0768bd03c 100644
> --- a/Documentation/MyFirstContribution.adoc
> +++ b/Documentation/MyFirstContribution.adoc
> @@ -26,7 +26,7 @@ useful additional context:
>  [[getting-help]]
>  === Getting Help
>  
> -If you get stuck, you can ask for help on the mailing list or Git community channels listed below.
> +If you get stuck, ask for help in the following places.

I do not quite understand this change.
Where are we getting that longer and less clear version?

The text in our source (both 'maint' and also 'seen') has

    [[getting-help]]
    === Getting Help

    If you get stuck, you can seek help in the following places.

and the above text has not changed since it was written in 4bb4fd42
(MyFirstContribution: add avenues for getting help, 2020-01-24).  So
there is nothing to "make it shorter" there.

Is "you can ask for help" materially better than "you can seek
help"?  As a non-native speaker, I cannot quite tell.  Both are
equally understandable to me, so I see nothing to "make it clearer"
there, either.

Puzzled...

      reply	other threads:[~2025-10-23 17:19 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-10-23 12:48 [PATCH] docs: simplify help sentence in MyFirstContribution.adoc QueenJcloud
2025-10-23 17:19 ` Junio C Hamano [this message]

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

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

  git send-email \
    --in-reply-to=xmqqjz0lv8lh.fsf@gitster.g \
    --to=gitster@pobox.com \
    --cc=christian.couder@gmail.com \
    --cc=git@vger.kernel.org \
    --cc=qjessa662@gmail.com \
    --cc=usmanakinyemi202@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.
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 NNTP newsgroup(s).