From: Daniel Stenberg <daniel@haxx.se>
Date: Tue, 11 Aug 2020 14:49:57 +0000 (+0200)
Subject: CONTRIBUTE: extend git commit message description
X-Git-Tag: curl-7_72_0~18
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=c46339eca10cdc4b9c83bd371835ed987086fb08;p=thirdparty%2Fcurl.git

CONTRIBUTE: extend git commit message description

In particular how the first line works.

Closes #5803
---

diff --git a/docs/CONTRIBUTE.md b/docs/CONTRIBUTE.md
index 978b87d27d..579ba32bb8 100644
--- a/docs/CONTRIBUTE.md
+++ b/docs/CONTRIBUTE.md
@@ -200,6 +200,16 @@ A short guide to how to write commit messages in the curl project.
     [whatever-else-by: credit all helpers, finders, doers]
     ---- stop ----
 
+The first line is a succinct description of the change:
+
+ - use the imperative, present tense: "change" not "changed" nor "changes"
+ - don't capitalize first letter
+ - no dot (.) at the end
+
+The `[area]` in the first line can be `http2`, `cookies`, `openssl` or
+similar. There's no fixed list to select from but using the same "area" as
+other related changes could make sense.
+
 Don't forget to use commit --author="" if you commit someone else's work, and
 make sure that you have your own user and email setup correctly in git before
 you commit