Reworded pull request creation examples.

JNRowe · JNRowe · commit 1924b46ade2a · 2011-07-12T17:12:10.000+01:00
diff --git a/doc/api/pull_requests.rst b/doc/api/pull_requests.rst
@@ -25,15 +25,18 @@ View a pull request
 Open pull request
 '''''''''''''''''
 
-To open a new pull request::
+To open a new pull request against the ``ask/python-github2`` project::
 
     >>> pull = github.pull_requests.create("ask/python-github2", "master",
     ...                                    "JNRowe:my_new_branch",
     ...                                    title="Fancy features")
     >>> pull.number
     4
 
-To attach code to an existing issue::
+This creates a pull request for changes in ``JNRowe``'s ``my_new_branch`` and
+asks for it to be merged to ``ask``'s ``master`` branch.
+
+To attach code to an existing issue and make it a pull request::
 
     >>> pull = github.pull_requests.create("ask/python-github2", "master",
     ...                                    "JNRowe:my_new_branch",
