update docs to reflect PRs from developer forks
clarify and add example for a commit message
Merge pull request #1215 from asmacdo/pull-request-conventions

updates docs to reflect new PR conventions