Pull request doc

@davidnalesnik - please look at these changes and tell me if they make things clearer.