On Wed, Jan 25, 2023 at 8:05 AM Adam Szkoda <adaszko@xxxxxxxxx> wrote: > On Tue, Jan 24, 2023 at 6:52 PM Junio C Hamano <gitster@xxxxxxxxx> wrote: > > > Range-diff vs v1: > > > > > > 1: 0ce06076242 < -: ----------- ssh signing: better error message when key not in agent > > > -: ----------- > 1: 03dfca79387 ssh signing: better error message when key not in agent > > > > This is a fairly useless range-diff. > > > > Even when a range-diff shows the differences in the patches, > > mechanically generated range-diff can only show _what_ changed. It > > is helpful to explain the changes in your own words to highlight > > _why_ such changes are done, and this place after the "---" line > > and the diffstat we see below is the place to do so. > > > > Does GitGitGadget allow its users to describe the differences since > > the previous iteration yourself? > > No, I don't think it does. It got generated automatically without > giving me an opportunity to edit. Yes, the user can describe the differences since the previous iteration by editing the pull-request's description. Specifically, when ready to send a new iteration: (1) force push the new iteration to the same branch on GitHub (2) edit the pull-request description; this is the very first "comment" on the pull-request page; press the "..." button on that comment and choose the "Edit" menu item; revise the text to describe the changes since the previous revision, then press the "Update comment" button to save (3) post a "/submit" comment to the pull-request to tell GitGitGadget to send the new revision to the Git mailing list