Implement gnupg commit message style
Open, LowPublic

Description

GnuPG has its own commit message style that is highly structured and contains valuable information. By integrating it in arc and phabricator, we can preserve and enhance it:

  • Parse existing commit messages (see https://secure.phabricator.com/T5132#69200)
    • Treat "gnupg-bug-id: xxx, yyy" like "Ref Txxx", "Ref Tyyy"
    • Parse the one-line summary and changelog section as summary.
    • Parse everything between "--" and the keyword list as "Test Plan".
    • Maybe parse keywords in first line and add them as projects.
    • Maybe link files in changelog-style section to the patch units or the files in the repo browser (if easy to do).
  • Extend gnupg commit message format by new featuresw
    • Add new keyword field "fixes-bug-id: xxx, yyy" and treat it like "Fixes xxx", "Fixes yyy" (autoclose).
    • Add new keyword field "reviewers: user1, user2".
    • Add new keyword field "auditors: user1, user2" to request a post-commit audit.
    • Add new keyword field "patch-id: Dxxx" (this will be automatically added by arc and links the commit to a patch)
    • Document new keyword in doc/HACKING
  • Changes in arc
    • Create a gnupg commit style template on initial commit message editing
    • Create new patch-id instead of "Differential revision:"
marcus created this task.Apr 6 2017, 5:53 PM
kai awarded a token.Apr 6 2017, 6:09 PM
marcus updated the task description. (Show Details)Apr 6 2017, 6:15 PM
werner added a subscriber: werner.Apr 6 2017, 6:22 PM

Please check whether similar keywords are already used by Linux.

We have used gnupg-bug-id: to indicate a fix. However, at the time of a commit you never know whether this is really a fix. Many reporters need to test it on their platform and that can take weeks. Thus I had the idea to simply reference the bug id (task).

doc/HACKING is mirrored at gnupg.org/faq/HACKING.org and I meanwhile think that we should make the web version the primary source.

marcus updated the task description. (Show Details)Apr 6 2017, 9:25 PM
marcus moved this task from KW 15 to KW 16 on the g10code Sprint board.Apr 18 2017, 9:52 AM
marcus edited projects, added g10code Sprint (KW 16); removed g10code Sprint (KW 15).
marcus moved this task from KW 16 to KW 17 on the g10code Sprint board.Apr 24 2017, 10:29 AM
marcus edited projects, added g10code Sprint (KW 17); removed g10code Sprint (KW 16).
marcus updated the task description. (Show Details)Apr 25 2017, 3:55 AM
marcus moved this task from KW 17 to KW 18 on the g10code Sprint board.May 2 2017, 10:13 AM
marcus edited projects, added g10code Sprint (KW 18); removed g10code Sprint (KW 17).
marcus moved this task from KW 18 to Backlog on the g10code Sprint board.May 8 2017, 9:54 AM
marcus edited projects, added g10code Sprint; removed g10code Sprint (KW 18).
marcus removed marcus as the assignee of this task.Oct 1 2017, 2:06 PM
werner lowered the priority of this task from High to Low.Oct 4 2017, 6:35 PM