doc: add comment on PR title and description

Signed-off-by: Lou Berger <lberger@labn.net>

diff --git a/doc/developer/workflow.rst b/doc/developer/workflow.rst
index 358cb9ac7bf79434e8fe09e147ba954e2755d990..5a88ac8d1fd2b44fa0994df3dfefa972ae2549b5 100644 (file)
--- a/doc/developer/workflow.rst
+++ b/doc/developer/workflow.rst
@@ -135,6 +135,11 @@ systems. Once the automated tests succeed, other developers will review your
 code for quality and correctness. After any concerns are resolved, your code
 will be merged into the branch it was submitted against.
 
+The title of the pull request should provide a high level technical
+summary of the included patches.  The description should provide
+additional details that will help the reviewer to understand the context
+of the included patches.
+
 Patch Submission via Mailing List
 ---------------------------------