minor documentation fixes (#814)

* fix typo in oauth docstring

* rephrased copy docstring to avoid confusion

* fix typos in a handful of models docstrings

gspread/auth.py

@@ -112,10 +112,10 @@ def oauth(scopes=DEFAULT_SCOPES, flow=local_server_flow):
 
         gc = gspread.oauth()
 
-    Another option is to run a console strategy. This way the user is
+    Another option is to run a console strategy. This way, the user is
     instructed to open the authorization URL in their browser. Once the
-    authorization is complete the user then must copy & paste
-    authorization code the application::
+    authorization is complete, the user must then copy & paste the
+    authorization code into the application::
 
         gc = gspread.oauth(flow=gspread.auth.console_flow)
 

gspread/client.py

@@ -212,9 +212,9 @@ def copy(self, file_id, title=None, copy_permissions=False):
 
         .. note::
 
-           If you're using custom credentials without Drive scope, in order to use 
-           this method, you need to add ``https://www.googleapis.com/auth/drive`` 
-           to your OAuth scope.
+           If you're using custom credentials without the Drive scope, you need to add 
+           ``https://www.googleapis.com/auth/drive`` to your OAuth scope in order to use 
+           this method.
 
            Example::
 
@@ -223,7 +223,7 @@ def copy(self, file_id, title=None, copy_permissions=False):
                   'https://www.googleapis.com/auth/drive'
               ]
 
-           Otherwise you will get an ``Insufficient Permission`` error
+           Otherwise, you will get an ``Insufficient Permission`` error
            when you try to copy a spreadsheet.
 
         """

gspread/models.py

@@ -242,7 +242,7 @@ def values_batch_update(self, params=None, body=None):
         return r.json()
 
     def _spreadsheets_get(self, params=None):
-        """A method stub that directly calls `spreadsheets.batchUpdate <https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/get>`_. """
+        """A method stub that directly calls `spreadsheets.get <https://developers.google.com/sheets/api/reference/rest/v4/spreadsheets/get>`_. """
         url = SPREADSHEET_URL % self.id
         r = self.client.request('get', url, params=params)
         return r.json()
@@ -1674,7 +1674,7 @@ def delete_dimension(self, dimension, start_index, end_index=None):
         return self.spreadsheet.batch_update(body)
 
     def delete_rows(self, start_index, end_index=None):
-        """Deletes multi rows from the worksheet at the specified index.
+        """Deletes multiple rows from the worksheet at the specified index.
 
         :param int start_index: Index of a first row for deletion.
         :param int end_index: Index of a last row for deletion.
@@ -1693,7 +1693,7 @@ def delete_rows(self, start_index, end_index=None):
         return self.delete_dimension('ROWS', start_index, end_index)
 
     def delete_columns(self, start_index, end_index=None):
-        """Deletes multi columns from the worksheet at the specified index.
+        """Deletes multiple columns from the worksheet at the specified index.
 
         :param int start_index: Index of a first column for deletion.
         :param int end_index: Index of a last column for deletion.