From d7aef9bd0bb8df6f2acbfbae02798aa81d95370f Mon Sep 17 00:00:00 2001 From: Stefano Lattarini Date: Thu, 10 Jan 2013 23:06:27 +0100 Subject: [PATCH] HACKING: "detailed explanation" in commit messages is almost mandatory Signed-off-by: Stefano Lattarini --- HACKING | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/HACKING b/HACKING index edafe94f1..c4f0ba815 100644 --- a/HACKING +++ b/HACKING @@ -148,8 +148,9 @@ Here goes a more detailed explanation of why the commit is needed, - and a general overview of what it does, and how. This section is - optional, but you are expected to provide it more often than not. + and a general overview of what it does, and how. This section + should almost always be provided, possibly only with the expection + of obvious fixes or very trivial changes. And if the detailed explanation is quite long or detailed, you can want to break it in more paragraphs. -- 2.47.2