From: Jonathan Tan <email@example.com> To: firstname.lastname@example.org Cc: email@example.com, firstname.lastname@example.org, email@example.com, firstname.lastname@example.org, email@example.com, firstname.lastname@example.org, email@example.com, Jonathan Tan <firstname.lastname@example.org> Subject: Re: [PATCH v4] hooks: propose project configured hooks Date: Wed, 2 Jun 2021 20:31:42 -0700 [thread overview] Message-ID: <email@example.com> (raw) In-Reply-To: <firstname.lastname@example.org> > +* After clone, repository suggests hooks to the user > + > + ** User receives a non-interactive message advertising hooks available to > + install > + > + ** User can see what hooks and commands are being suggested and from what > + remote. From the implementation point of view, would it be sufficient to just advertise that hooks are available? Assuming that the hooks will be available from a specially named ref (as stated below), then we would only need to inform the user that this ref exists and hooks can be inspected using a special command. Likewise for when we fetch and notice that the ref now points to a different object. Then, we wouldn't need to do any extra fetching upon clone/fetch, saving time and bandwidth, but just do so if the user requests it. > +Feature Requirements > +~~~~~~~~~~~~~~~~~~~~ > + > +Minimum Feature Set > +^^^^^^^^^^^^^^^^^^^ [snip] > +* The configuration specifies where the hook commands reside > + > + ** This could be a path to a script/binary within the repository > + > + ** This could be a path to a script/binary contained within submodules of > + the repository > + > + ** This could be a user installed command or script/binary that exists > + outside of the repository and is present in `$PATH` Right now hooks are fixed files (well, not counting Emily Shaffer's work on config hooks). Would it be sufficient to just provide replacements for those files? > +* The configuration lives outside the worktree. > + > + ** Allows updated hooks to apply across history and branches, reducing > + the maintenance burden of keeping hooks updated. > + > + ** Allows different remotes to specify different configuration. This is > + useful for public vs private central repositories or for repositories which > + support different Git functionality. Hmm...what would be a use case of this? And how would, say, a pre-commit hook know which remote it is for? > +* The user receives advice to install hooks. > + > + ** The advice should clearly indicate the suggested hook command(s) and hook > + event(s) as well as the central repository that is suggesting them (via > + remote URL). > + > + ** The user should be able to use configuration to turn off this advice. > + > + ** The advice should appear at the following times: > + > + *** After a clone > + > + *** After a suggested hook would have run if not already installed. The > + advice should include commands for installing the hook and invoking it. > + For example, for a hook on 'git commit', the user should receive advice > + to amend their commit after hook installation. This seems contradictory to a point above where we only inform the user upon clone (when the user is in the setup mood). > +* If, after fetch, the central repository suggests new or updated hooks, the > +user should receive advice to install these new hooks (note: implementation > +should not interfere with requirement listed in“Fast Follows") In Git, the term "advice" seems to be used more for extra explanations that you can turn off once you're experienced with Git. Here, these seem like things that we would want to notify users about regardless of experience level, so maybe the word "notification" is more appropriate. > +* Works across Windows/Linux/macOS > + > +Fast Follows > +^^^^^^^^^^^^ > + > +* Behind configuration, a user can opt to automatically install hook updates > +from a given remote. > + > +* Allow users to make trust decisions based on GPG signing e.g. if the > +configuration came from a signed commit, the signature could be shown along > +with the remote it came from. For the MVP, do we need this? > +Implementation Exploration: Check special config branch at fetch time > +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ > + > +* Perform fetch as normal > + > +* After fetch is complete, Git checks for a "magic" config branch (e.g. > ++origin/refs/recommended-config+) which contains information about config lines > +an end-user may want, including hooks. > + > +* As part of the fetch subcommand, Git alerts users (but not interactively) they > +can install install the configs contained there. This doesn't describe what the "magic" ref points to, but it could point to a tree containing the hooks.
next prev parent reply other threads:[~2021-06-03 3:37 UTC|newest] Thread overview: 39+ messages / expand[flat|nested] mbox.gz Atom feed top 2021-03-18 22:03 [PATCH] hooks: propose repository owner " Albert Cui via GitGitGadget 2021-03-18 22:29 ` Junio C Hamano 2021-03-18 23:45 ` Albert Cui 2021-03-19 1:28 ` brian m. carlson 2021-03-19 10:27 ` Ævar Arnfjörð Bjarmason 2021-04-06 0:35 ` Albert Cui 2021-04-07 22:47 ` Ævar Arnfjörð Bjarmason 2021-06-21 19:36 ` Jonathan Tan 2021-06-21 20:35 ` Ævar Arnfjörð Bjarmason 2021-03-26 1:43 ` [PATCH v2] hooks: propose project " Albert Cui via GitGitGadget 2021-03-29 23:20 ` Emily Shaffer 2021-04-01 20:02 ` Albert Cui 2021-03-30 15:24 ` Derrick Stolee 2021-04-05 22:45 ` Albert Cui 2021-04-05 23:09 ` Junio C Hamano 2021-04-05 23:40 ` Albert Cui 2021-04-06 0:13 ` Junio C Hamano 2021-04-06 0:27 ` Albert Cui 2021-04-06 23:15 ` brian m. carlson 2021-04-07 7:53 ` Ævar Arnfjörð Bjarmason 2021-04-07 13:09 ` Derrick Stolee 2021-04-07 18:40 ` Albert Cui 2021-04-07 20:02 ` Junio C Hamano 2021-04-07 22:23 ` Ævar Arnfjörð Bjarmason 2021-04-15 16:52 ` Ed Maste 2021-04-15 19:41 ` Junio C Hamano 2021-04-15 20:37 ` Ed Maste 2021-04-15 20:50 ` Junio C Hamano 2021-04-15 22:28 ` brian m. carlson 2021-04-02 9:59 ` Ævar Arnfjörð Bjarmason 2021-04-05 23:42 ` Albert Cui 2021-04-02 10:30 ` Ævar Arnfjörð Bjarmason 2021-04-03 0:58 ` Albert Cui 2021-04-24 1:38 ` [PATCH v3] " Albert Cui via GitGitGadget 2021-04-28 2:48 ` Junio C Hamano 2021-05-05 19:11 ` [PATCH v4] " Albert Cui via GitGitGadget 2021-06-03 3:31 ` Jonathan Tan [this message] 2021-06-03 20:16 ` Albert Cui 2021-06-03 22:10 ` Jonathan Tan
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 \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ --email@example.com \ --firstname.lastname@example.org \ --subject='Re: [PATCH v4] hooks: propose project configured hooks' \ /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
Code repositories for project(s) associated with this 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).