Added gist reference to import_issue and included code examples.

itsmemattchung · itsmemattchung · commit ffd11d1fe767 · 2016-01-19T12:48:47.000Z
diff --git a/docs/examples/issue.rst b/docs/examples/issue.rst
@@ -49,3 +49,32 @@ Or how to do the same by wrapping the lines in your terminal.
 
 .. literalinclude:: source/wrap_text.py
     :language: python
+
+Importing an issue
+------------------
+
+Not only can you create new issues, but you can import existing ones.   When importing, you preserve the timestamp creation date; you can preserve the timestamp(s) for comment(s) too.
+
+::
+
+   import github3
+   gh = github3.login(token=token)
+   issue = {
+      'title': 'Documentation issue',
+      'body': 'Missing links in index.html',
+      'created_at': '2011-03-11T17:00:40Z'
+   }
+
+   repository = gh.repository(user, repo)
+   repository.import_issue(**issue)
+
+Status of imported issue
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Here's how to check the status of the imported issue.
+
+::
+
+    import github3
+    issue = repository.imported_issue(issue_num)
+    print issue.status
diff --git a/github3/repos/repo.py b/github3/repos/repo.py
@@ -1282,7 +1282,9 @@ def imported_issue(self, imported_issue_id):
     @requires_auth
     def import_issue(self, title, body, created_at, assignee=None,
                      milestone=None, closed=None, labels=None, comments=None):
-        """Import issue into this repository.
+        """Import an issue into the repository.
+
+        See also: https://gist.github.com/jonmagic/5282384165e0f86ef105
 
         :param string title: (required) Title of issue
         :param string body: (required) Body of issue
