add some docs I missed

Nat Williams · Nat Williams · commit 286cf17b2389 · 2012-04-16T13:48:54.000-05:00
diff --git a/pygithub3/requests/git_data/blobs.py b/pygithub3/requests/git_data/blobs.py
@@ -5,13 +5,11 @@
 
 
 class Get(Request):
-
     uri = 'repos/{user}/{repo}/git/blobs/{sha}'
     resource = Blob
 
 
 class Create(Request):
-
     uri = 'repos/{user}/{repo}/git/blobs'
     resource = Blob
     body_schema = {
diff --git a/pygithub3/requests/git_data/commits.py b/pygithub3/requests/git_data/commits.py
@@ -16,5 +16,3 @@ class Create(Request):
         'schema': ('message', 'tree', 'parents', 'author', 'committer'),
         'required': ('message', 'tree', 'parents'),
     }
-
-
diff --git a/pygithub3/services/git_data/blobs.py b/pygithub3/services/git_data/blobs.py
@@ -11,14 +11,22 @@ def get(self, sha, user=None, repo=None):
         """Get a particular blob
 
         :param str sha: The sha of the blob to get
+        :param str user: Username
+        :param str repo: Repository
 
         """
         request = self.make_request('git_data.blobs.get', sha=sha,
                                        user=user, repo=repo)
         return self._get(request)
 
     def create(self, data, user=None, repo=None):
-        """Create a blob"""
+        """Create a blob
+
+        :param dict data: Data describing the blob to create
+        :param str user: Username
+        :param str repo: Repository
+
+        """
         request = self.make_request('git_data.blobs.create', body=data,
                                     user=user, repo=repo)
         return self._post(request)
diff --git a/pygithub3/services/git_data/commits.py b/pygithub3/services/git_data/commits.py
@@ -8,7 +8,13 @@ class Commits(Service):
     """Consume `Commits API <http://developer.github.com/v3/git/commits/>`_"""
 
     def get(self, sha, user=None, repo=None):
-        """get a commit from the current repo"""
+        """get a commit from the current repo
+
+        :param str sha: SHA of the Commit that you want.
+        :param str user: Username
+        :param str repo: Repository
+
+        """
         request = self.make_request('git_data.commits.get', sha=sha,
                                        user=user, repo=repo)
         return self._get(request)
diff --git a/pygithub3/services/git_data/references.py b/pygithub3/services/git_data/references.py
@@ -13,6 +13,10 @@ def get(self, ref, user=None, repo=None):
         .. note::
             Remember that branch references look like "heads/<branch_name>"
 
+        :param str ref: the name of the reference to get
+        :param str user: Username
+        :param str repo: Repository
+
         """
         return self._get(
             self.make_request('git_data.references.get', ref=ref, user=user,
@@ -24,6 +28,8 @@ def list(self, namespace='', user=None, repo=None):
 
         :param str namespace: Limit the request to a particular type of
                               reference. For example, ``heads`` or ``tags``.
+        :param str user: Username
+        :param str repo: Repository
 
         """
         return self._get(
@@ -34,8 +40,8 @@ def create(self, body, user=None, repo=None):
         """Create a reference
 
         :param dict body: Data describing the reference to create
-        :param str user: username
-        :param str repo: repository name
+        :param str user: Username
+        :param str repo: Repository
 
         """
         return self._post(
@@ -47,7 +53,9 @@ def update(self, ref, body, user=None, repo=None):
         """Update an existing reference
 
         :param str ref: The SHA of the reference to update
-        :param dict body: data
+        :param dict body: Data to update the reference with
+        :param str user: Username
+        :param str repo: Repository
 
         """
         return self._patch(
@@ -59,6 +67,8 @@ def delete(self, ref, user=None, repo=None):
         """Delete a reference
 
         :param str ref: The SHA of the reference to delete
+        :param str user: Username
+        :param str repo: Repository
 
         """
         return self._delete(

Original file line number	Diff line number	Diff line change
`@@ -16,5 +16,3 @@ class Create(Request):`
`16`	`16`	`'schema': ('message', 'tree', 'parents', 'author', 'committer'),`
`17`	`17`	`'required': ('message', 'tree', 'parents'),`
`18`	`18`	`}`
`19`		`-`
`20`		`-`