On Tue, Apr 23, 2024 at 11:28:03PM -0700, Junio C Hamano wrote: > James Liu <james@xxxxxxxxxxx> writes: > > > This patch series adds an "all" advice hint type that can be used as a > > convenience option for disabling all advice hints. > > Hmph. I thought this was rejected already and not in so distant > past, but I am not finding a discussion thread in the archive. > > The design to support the advice.* variables to let individual ones > to be squelched, without allowing "all", is very much deliberate. > > A user may think they are familiar with all the advices already, but > with "all", they'll never get a chance to learn new ones added after > they set the configuration. Looking from the other direction, a new > advice message is a way for us to tell our users something important > for them to know. For example, we may plan to improve a high-level > Porcelain command so that it will eventually error out when given an > input that used to be accepted but behaved in a way that newbies > felt confusing. In the first step of such a transition, we will > introduce a new (and hopefully better) way to achieve what the user > wants to do, and add an advice message to tell the user, when they > trigger the codepath whose behaviour will change in the future, in > the old way that will eventually go away. > > Do not close that communication channel on us. While I agree that it might not be a good idea to set it for our users, the usecase mentioned by this patch series is scripting. And here I very much agree with the sentiment that it makes sense to give an easy knob to disable all advice (disclosure: James is part of the Gitaly team at GitLab, and that is where this feature comes from, so I am very much biased). It has happened multiple times to us that new advices were introduced that then subsequently caused regressions in Gitaly because the output of Git commands now looks different. While addressing such breakage is easy enough to do, it does add up if we have to run Git with every single advice that we may hit turned off individually. Now one could say that we shouldn't execute porcelain tools in our scripts because it is kind of expected that their output may change at any point in time, and that is certainly true. But the reality is that there aren't always good plumbing alternatives available. Furthermore, we are often forced to parse fragile error messages from such porcelain tools because Git doesn't provide a better way to dissect errors. Error codes are mostly meaningless and there is no other data channel available to us than the error message. These are problems that run deeper than "We want to disable advices", and we eventually want to address those over time. But it's a long road to get there, and meanwhile disabling all advice would be something that helps us make our scripted uses of Git at least a tiny bit more stable. Patrick
Attachment:
signature.asc
Description: PGP signature
