[PATCH 1/3] checkpatch: warn about novice phrases in commit messages

From: Ignacio Peña
Date: Mon Jul 21 2025 - 12:26:09 EST


Add detection for common phrases used by newcomers that make patches
look less professional, such as "please apply" or "please consider".

These phrases are unnecessary and can make the submission appear less
confident. The kernel development process expects direct, professional
communication without apologetic or pleading language.

This check helps newcomers learn the expected communication style,
reducing the chance of patches being dismissed due to poor presentation
rather than technical merit.

Link: https://docs.kernel.org/process/submitting-patches.html#describe-your-changes
Suggested-by: Greg Kroah-Hartman <gregkh@xxxxxxxxxxxxxxxxxxx>
Signed-off-by: Ignacio Pena <ignacio.pena87@xxxxxxxxx>
---
scripts/checkpatch.pl | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)

diff --git a/scripts/checkpatch.pl b/scripts/checkpatch.pl
index e722dd6fa..7ccdc774a 100755
--- a/scripts/checkpatch.pl
+++ b/scripts/checkpatch.pl
@@ -3266,6 +3266,26 @@ sub process {
"A patch subject line should describe the change not the tool that found it\n" . $herecurr);
}

+
+# Check for novice phrases in commit message
+ if ($in_commit_log && !$non_utf8_charset) {
+ my @novice_phrases = (
+ qr/please\s+(apply|merge|consider|review)/i,
+ qr/hope\s+this\s+helps/i,
+ qr/my\s+first\s+(patch|contribution)/i,
+ qr/(newbie|beginner)\s+here/i,
+ qr/not\s+sure\s+if\s+(this\s+is\s+)?correct/i,
+ qr/sorry\s+(if|for)/i,
+ );
+
+ foreach my $phrase (@novice_phrases) {
+ if ($line =~ /$phrase/) {
+ WARN("COMMIT_MESSAGE_NOVICE",
+ "Avoid apologetic or uncertain language - be direct and professional\n" . $herecurr);
+ last;
+ }
+ }
+ }
# Check for Gerrit Change-Ids not in any patch context
if ($realfile eq '' && !$has_patch_separator && $line =~ /^\s*change-id:/i) {
if (ERROR("GERRIT_CHANGE_ID",
--
2.50.1