While the wiki links to the great article, I wonder if it would make sense to explicitly call out the parts that we most care about in the wiki itself, especially if we end up agreeing that not meeting some criteria might result in a rejected PR. To me those would be violating the format and not including the "why?" when it's not obvious. I honestly care less about details on the "what?" in most cases, since the commit itself obviously includes all the changes.
On Fri, Sep 14, 2018 at 3:08 PM, Kirk Lund <kl...@apache.org> wrote: > Correction! The wiki page does have a link to > *https://chris.beams.io/posts/git-commit/ > <https://chris.beams.io/posts/git-commit/> *at the bottom of the page: > > How to write a Git commit message <https://chris.beams.io/posts/ > git-commit/> > > On Fri, Sep 14, 2018 at 3:05 PM, Kirk Lund <kl...@apache.org> wrote: > > > *The commit message should follow imperative style.* The wiki page seems > > to be missing this even though we agreed to it several times on the > > dev-list over the last 3 years. I'll add this to the wiki page. > > > > You can then say *"If I apply this commit, then it will..."* for any of > > the git commits. For an explanation, see *https://chris.beams.io/posts/ > git-commit/ > > <https://chris.beams.io/posts/git-commit/>* > > > > Example: > > > > *Use this:* > > > > *GEODE-xxxx: Fix failing CompositePropertySourceTest* > > > > Instead of: > > GEODE-xxxx: Fixing failing CompositePropertySourceTest > > GEODE-xxxx: Fixed failing CompositePropertySourceTest > > > > And *definitely* instead of: > > GEODE-xxxx: failing CompositePropertySourceTest > > GEODE-xxxx: polishing stuff > > GEODE-xxxx: CompositePropertySourceTest is failing intermittently > > > > Just to be clear, these last 5 are examples of how you should NOT word > the > > commit message. > > > > On Fri, Sep 14, 2018 at 12:11 PM, Alexander Murmann <amurm...@pivotal.io > > > > wrote: > > > >> I do find it very helpful to have the ticket number at the beginning of > >> the > >> title. It makes it really easy to scan the output of `git log --oneline` > >> or > >> GitX to see what tickets happened recently or since a certain tag. > >> > >> On Fri, Sep 14, 2018 at 11:55 AM, Bradford Boyle <bbo...@pivotal.io> > >> wrote: > >> > >> > How would people feel about removing the requirement to include the > >> > "GEODE-XXXX: " prefix in the summary line? That accounts for about 25% > >> of > >> > the 52 character limit. We could move it to the first non-summary line > >> of > >> > the commit message. > >> > > >> > --Bradford > >> > > >> > > > > >