Tweak style and content of last commit

The directions here anticipate planned improvements to our JIRA bot to
allow issues to be resolved by placing the JIRA directives in the body
of the commit message.

docs/SubmittingPatches

@@ -76,21 +76,21 @@ message might look like this:
 > 
 > After appropriate amounts of frobbing have been done, a new variable
 > `frobbing_done` is set in the caller's channel.
+> 
+> FS-XXXX --resolve
 
-Patches related to JIRA issues
+Patches Related to JIRA Issues
 ------------------------------
 
-If your patch is related to an JIRA issue, you should add its name
+When your patch is related to an issue logged in JIRA, add the
-(i.e. FS-555) to your commit message. You can also use some JIRA
+identifier for the issue (e.g. FS-XXXX) to the body of your commit
-directives, like '--resolve'. For example, if your patch fixes some
+message at the beginning of a line, typically the last line or just
-error reported by case FS-555, just add the following line somewhere
+before "Signed-off-by:" and "Thanks-to:" lines.  This helps our JIRA
-in your commit message:
+bot do useful things by relating the commit to the issue.
 
-> FS-555 --resolve
+If you believe your patch resolves the issue in question, follow the
-
+issue number with a space and the "--resolve" directive as in the
-or modify the subject:
+example above.
-
-> FS-555 --resolve Add frobinator support to mod_sofia
 
 Where to Go for Help
 --------------------