Index: include/asterisk/doxygen/commits.h
===================================================================
--- include/asterisk/doxygen/commits.h	(revision 251939)
+++ include/asterisk/doxygen/commits.h	(working copy)
@@ -47,6 +47,14 @@
  * paragraphs, itemized lists, etc. Always end the first sentence (and any
  * subsequent sentences) with punctuation.
  *
+ * The one line summary of changes should be just that.  Remember that in most
+ * cases this summary will show up in the ChangeLog and should briefly describe
+ * what is being fixed or added.  Examples of inadequate change summaries are:
+ *
+ * \arg "Let's not do that again, m'kay?"
+ * \arg "Implement something suggested in #asterisk-dev"
+ * \arg "Adding braces."
+ *
  * Commit messages should be wrapped at 80 %columns.
  *
  * \note For trivial commits, such as "fix the build", or "fix spelling mistake",