Minor fixes, move project settings section down in overview

Author: vshlapakov

docs/client/overview.rst

@@ -20,7 +20,8 @@ for access to client projects.
 Projects
 --------
 
-You can list the projects available to your account::
+You can list the :class:`~scrapinghub.client.projects.Projects` available to your
+account::
 
     >>> client.projects.list()
     [123, 456]
@@ -67,31 +68,6 @@ For example, to schedule a spider run (it returns a
     <scrapinghub.client.Job at 0x106ee12e8>>
 
 
-Settings
---------
-
-You can work with project settings via :class:`~scrapinghub.client.projects.Settings`.
-
-To get a list of the project settings::
-
-    >>> project.settings.list()
-    [(u'default_job_units', 2), (u'job_runtime_limit', 24)]]
-
-To get a project setting value by name::
-
-    >>> project.settings.get('job_runtime_limit')
-    24
-
-To update a project setting value by name::
-
-    >>> project.settings.set('job_runtime_limit', 20)
-
-Or update a few project settings at once::
-
-    >>> project.settings.update({'default_job_units': 1,
-    ...                          'job_runtime_limit': 20})
-
-
 Spiders
 -------
 
@@ -428,6 +404,30 @@ Or post multiple events at once::
     >>> project.activity.add(events)
 
 
+Settings
+--------
+
+You can work with project settings via :class:`~scrapinghub.client.projects.Settings`.
+
+To get a list of the project settings::
+
+    >>> project.settings.list()
+    [(u'default_job_units', 2), (u'job_runtime_limit', 24)]]
+
+To get a project setting value by name::
+
+    >>> project.settings.get('job_runtime_limit')
+    24
+
+To update a project setting value by name::
+
+    >>> project.settings.set('job_runtime_limit', 20)
+
+Or update a few project settings at once::
+
+    >>> project.settings.update({'default_job_units': 1,
+    ...                          'job_runtime_limit': 20})
+
 
 Collections
 -----------

docs/quickstart.rst

@@ -69,7 +69,7 @@ By default, tests use VCR.py ``once`` mode to:
 It means that if you add new integration tests and run all tests as usual,
 only new cassettes will be created, all existing cassettes will stay unmodified.
 
-To ignore existing cassettes and use real service, please provide a flag::
+To ignore existing cassettes and use real services, please provide a flag::
 
     py.test --ignore-cassettes
 

scrapinghub/client/proxy.py

@@ -62,7 +62,10 @@ def get(self, key, **params):
         return self._origin.get(key, **params)
 
     def write(self, item):
-        """Write new element to collection."""
+        """Write new element to collection.
+
+        :param item: element data dict to write.
+        """
         try:
             return self._origin.write(item)
         except _ValueTooLarge as exc: