git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: Dragan Simic <dsimic@manjaro.org>
To: Junio C Hamano <gitster@pobox.com>
Cc: git@vger.kernel.org, code@khaugsbakk.name
Subject: Re: [PATCH v4] send-email: make it easy to discern the messages for each patch
Date: Sat, 06 Apr 2024 12:18:31 +0200	[thread overview]
Message-ID: <713c28cfc9dff2d01159105ddd2fd0f5@manjaro.org> (raw)
In-Reply-To: <e90f6c80be33b2b54e20992f19e417dc@manjaro.org>

On 2024-04-06 10:56, Dragan Simic wrote:
> On 2024-04-06 07:40, Junio C Hamano wrote:
>> Dragan Simic <dsimic@manjaro.org> writes:
>> 
>>> Following the approach of making the produced output more readable, 
>>> also
>>> emit additional vertical whitespace after the "Send this email 
>>> [y/n/...]?"
>>> prompt.
>> 
>> Hmph.  I'd prefer to see you try not to endlessly extend the scope
>> of a topic.
>> 
>> By including the above change, the patch no longer is small and
>> focused enough, which was the reason why we said that the "let's
>> move the final newline out of the translatable string" can be done
>> as a "while at it" change.
>> 
>> Besides, because of the switch to separator semantics, that hunk
>> lost the reason to exist as part of the "use a blank line between
>> output for each message"---the change no longer is needed to support
>> the feature.
>> 
>> Even though it is a good change to have, and it deserves to be
>> justified by its merit alone.
>> 
>> The whole thing deserves to be a three-patch series, the first one
>> being a preliminarly "let's move the final newline out of the
>> translatable string" step, followed by "let's have a gap between
>> output for each patch sent out".  Perhaps another "even during
>> sending a single patch, we may want extra blank lines when use of
>> editor and other user interation is involved" patch on top.
>> 
>> I haven't formed an opinion on that last step, and I do not think I
>> can spend any time to think about that new part of the feature for
>> some time (others can review that part and give their opinion on it,
>> of course, while I'll be working on other topics).  It would mean
>> you are adding yet another feature to delay the base improvement to
>> stabilize.  You really do not want to do that.
> 
> Quite frankly, I think all these changes are small enough and
> understandable enough to be fine for being squashed into a single
> patch.  See, I love perfection and I'm also kind of a perfectionist,
> but such an approach can sometimes actually become counterproductive.
> That's what I usually refer to as being pragmatic, in the sense of
> making things a bit less perfect but still fine, in the interest
> of "getting things done", so to speak.  I hope it makes sense.
> 
> However, if you insist I'm also perfectly fine with splitting this
> patch into a three-patch series.  That would make it perfect, there's
> no doubt about it, but would it be a pragmatic approach, worth the
> additional time and effort?  Perhaps not.

After thinking a bit more about it, I agree that splitting this
patch into a three-patch series is the right thing to do.  As
you described it above, changes introduced in some versions of
the patch made the original assumptions about squashing the changes
together no longer apply.  I'll split this patch into three separate
patches and send those over.

As a note, I think that making the outputs of "git send-mail" more
readable is quite important, because we've seen people complaining
about the whole process of sending patches to mailing lists.  Making
the outputs more readable can only help, if you agree.

>> In any case, this [v4], as a single ball of wax, is not something I
>> can confidently say "I reviewed this and looks OK".


  reply	other threads:[~2024-04-06 10:18 UTC|newest]

Thread overview: 8+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-04-06  1:48 [PATCH v4] send-email: make it easy to discern the messages for each patch Dragan Simic
2024-04-06  5:40 ` Junio C Hamano
2024-04-06  8:56   ` Dragan Simic
2024-04-06 10:18     ` Dragan Simic [this message]
2024-04-06 17:05   ` Junio C Hamano
2024-04-06 17:08     ` Dragan Simic
2024-04-08 16:01       ` Junio C Hamano
2024-04-08 16:15         ` Dragan Simic

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=713c28cfc9dff2d01159105ddd2fd0f5@manjaro.org \
    --to=dsimic@manjaro.org \
    --cc=code@khaugsbakk.name \
    --cc=git@vger.kernel.org \
    --cc=gitster@pobox.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).