[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: who needs script `update-patch-version`?

From: Michael Käppler
Subject: Re: who needs script `update-patch-version`?
Date: Mon, 1 Feb 2021 15:22:22 +0100
User-agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:78.0) Gecko/20100101 Thunderbird/78.7.0

Am 01.02.2021 um 12:39 schrieb Jonas Hahnfeld:
Am Montag, dem 01.02.2021 um 12:11 +0100 schrieb Werner LEMBERG:
Right now I'm completely revising `programming-work.itexi`, so I
can take care of that, too.
It would be great if you can structure the revision as incremental
updates and not as a big dump. Those are quite tedious to review
and usually take much longer to go through...
Unfortunately, this is next to impossible since there are so many
No, it is possible if you are willing to structure your changes in an
incremental way. For example, removing an outdated section with no
replacement should be a separate commit - easy to skip when reviewing.
Updating a particular (group of) information should be a separate
commit so that you don't have to remember all changes when reviewing.
Moving a section around should be a separate commit. And so on.
Sometimes, however, it may well be appropriate to rewrite a section from
scratch, if it is too big a mess.
Then incremental changes would not make much sense to me.
I mean, we have *very* few people working on the docs and I'm happy about
everyone contributing in this area. While supporting the working style you
mentioned, we should also be careful not to scare off potential contributors
(Trevor already gave an example)


reply via email to

[Prev in Thread] Current Thread [Next in Thread]