git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Junio C Hamano <gitster@pobox.com>
To: Ben Knoble <ben.knoble@gmail.com>
Cc: Patrick Steinhardt <ps@pks.im>,
	 Meet Soni <meetsoni3017@gmail.com>,
	git@vger.kernel.org,  shejialuo@gmail.com
Subject: Re: [GSoC][PATCH] builtin/refs: add 'get' subcommand
Date: Wed, 24 Sep 2025 10:11:08 -0700	[thread overview]
Message-ID: <xmqq7bxnn5cj.fsf@gitster.g> (raw)
In-Reply-To: <4FEB2B85-FC32-4076-9DA6-F47AAB096CB0@gmail.com> (Ben Knoble's message of "Wed, 24 Sep 2025 11:29:11 -0400")

Ben Knoble <ben.knoble@gmail.com> writes:

>>> Perhaps "show-ref --verify --no-deref" or something that does not
>>> dereference but works directly on a symbolic ref?
>> 
>> For now: yes, it's more difficult to discover for sure. But users will
>> adjust over time as they get more familiar with git-refs(1), and from
>> thereon I think it will become significantly easier to discover that
>> subcommand.

But unfortunately, that is a tautology, isn't it?  With the same
effort to advertise git-refs to make it more familiar to the
"users", you can make "show-ref" familiar to the same "users", and
problem solved, without a need to do anything to "git-refs"?

> I think this goes to perhaps some of my unasked questions: who is
> the target audience? My experience suggest that most
> mostly-porcelain users don’t acquire familiarity with scripting
> commands, so it sounds like we’re talking about script-writers
> here (and in the commit message).
>
> But how do we encourage script writers to discover these things? 🤔 Hm. 

Great question.  I understand what the patch author is trying to
achieve (i.e. "consolidate ref-related functionality into git-refs",
which is the title of GSoC project [*]), but what are we, as Git
project, trying to achive by "consolidating"?  I often cannot shake
the feeling that it may a make-work job without a clear answer to
that question.  Or perhps xkcd.com/927/?

Perhaps the hope is to have a single kitchen sink "git refs" command
that does anything related to "refs", so that they only need to
learn this single command (and unlearn all the previous experiences
they gained) and after that, they do not have to "discover" more
things?




[Reference]

* https://summerofcode.withgoogle.com/programs/2025/projects/xVrT5e2q

  reply	other threads:[~2025-09-24 17:11 UTC|newest]

Thread overview: 11+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-09-23 10:45 [GSoC][PATCH] builtin/refs: add 'get' subcommand Meet Soni
2025-09-23 16:57 ` Ben Knoble
2025-09-24  6:32   ` Patrick Steinhardt
2025-09-23 21:50 ` Junio C Hamano
2025-09-24  6:32   ` Patrick Steinhardt
2025-09-24 15:29     ` Ben Knoble
2025-09-24 17:11       ` Junio C Hamano [this message]
2025-09-25  6:25         ` Patrick Steinhardt
2025-09-25 18:08           ` D. Ben Knoble
2025-09-25 18:43             ` Junio C Hamano
2025-09-24  6:32 ` Patrick Steinhardt

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=xmqq7bxnn5cj.fsf@gitster.g \
    --to=gitster@pobox.com \
    --cc=ben.knoble@gmail.com \
    --cc=git@vger.kernel.org \
    --cc=meetsoni3017@gmail.com \
    --cc=ps@pks.im \
    --cc=shejialuo@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).