Review the whole documentation

Author: BoboTiG

.gitignore

@@ -13,3 +13,4 @@ MANIFEST*
 .pytest_cache
 .tox
 .vscode
+docs/output/

docs/source/api.rst

@@ -16,6 +16,8 @@ GNU/Linux
 
     Contains the latest Xlib or XRANDR function.
 
+    .. versionadded:: 4.0.0
+
 .. class:: MSS
 
     .. method:: __init__([display=None])
@@ -60,10 +62,10 @@ GNU/Linux
 
     .. method:: grab(monitor)
 
-        :rtype: :class:`mss.base.ScreenShot`
+        :rtype: :class:`~mss.base.ScreenShot`
         :raises ScreenShotError: When color depth is not 32 (rare).
 
-        See :meth:`mss.base.MSSMixin.grab()` for details.
+        See :meth:`~mss.base.MSSMixin.grab()` for details.
 
 .. function:: error_handler(display, event)
 
@@ -76,7 +78,7 @@ GNU/Linux
     Error handler passed to `X11.XSetErrorHandler()` to catch any error that can happen when calling a X11 function.
     This will prevent Python interpreter crashes.
 
-    When such an error happen, a :class:`mss.exception.ScreenShotError` exception is raised and all `XError` information are added to the :attr:`mss.exception.ScreenShotError.details` attribute.
+    When such an error happen, a :class:`~mss.exception.ScreenShotError` exception is raised and all `XError` information are added to the :attr:`~mss.exception.ScreenShotError.details` attribute.
 
     .. versionadded:: 3.3.0
 
@@ -106,7 +108,10 @@ Methods
 
     .. method:: close()
 
-        Clean-up method. Does nothing by default.
+        Clean-up method. Does nothing by default. For more information, see specific implementations:
+
+            - :meth:`~mss.linux.MSS.close()` for GNU/Linux
+            - :meth:`~mss.windows.MSS.close()` for Windows
 
         .. versionadded:: 4.0.0
 
@@ -148,7 +153,7 @@ Methods
 
                 IOerror: [Errno 22] invalid mode ('wb') or filename: 'sct_1-2019-01-01 21:20:43.114194.png'
 
-            To fix this, you must provide a custom formatting.
+            To fix this, you must provide a custom date formatting.
 
     .. method:: shot()
 
@@ -204,7 +209,7 @@ Methods
 
     .. versionadded:: 3.0.0
 
-    .. versionadded:: 3.2.0
+    .. versionchanged:: 3.2.0
 
         The *level* keyword argument to control the PNG compression level.
 
@@ -331,5 +336,3 @@ Factory
 .. function:: mss()
 
     Factory function to instance the appropriate MSS class.
-
-    :rtype: :class:`mss.base.MSSMixin`

docs/source/developers.rst

@@ -34,7 +34,9 @@ How to Test?
 Launch the test suit::
 
     $ tox
-    # TOXENV=py37 tox
+
+    # or
+    $ TOXENV=py37 tox
 
 This will test MSS and ensure a good code quality.
 

docs/source/support.rst

@@ -4,7 +4,8 @@ Support
 
 Feel free to try MSS on a system we had not tested, and let report us by creating an `issue <htps://github.com/BoboTiG/python-mss/issues>`_.
 
-GNU/Linux, macOS and Windows: **2.7**, 3.5, 3.6 and **3.7**.
+    - OS: GNU/Linux, macOS and Windows
+    - Python: 2.7, 3.5, 3.6 and **3.7**
 
 
 Future
@@ -29,5 +30,3 @@ Abandoned
 - Python 3.2 (2016-10-08)
 - Python 3.3 (2017-12-05)
 - Python 3.4 (2018-03-19)
-
-By the way, if you find the *force*, give it a try and tell us if you managed to make one of these versions working (a patch should be quite easy).

docs/source/usage.rst

@@ -39,7 +39,7 @@ So the module can be used as simply as::
         sct.grab()
         # or any attribute/method of sct
 
-    Then you will have to **manually** call :meth:`mss.linux.MSSMixin.close()` to free resources.
+    Then you will have to **manually** call :meth:`~mss.base.MSSMixin.close()` to free resources.
 
 .. warning::
 

docs/source/where.rst

@@ -23,7 +23,7 @@ AI, Computer Vison
 Games
 =====
 
-- Go Review Partner <https://github.com/pnprog/goreviewpartner>`_, a tool to help analyse and review your game of go (weiqi, baduk) using strong bots;
+- `Go Review Partner <https://github.com/pnprog/goreviewpartner>`_, a tool to help analyse and review your game of go (weiqi, baduk) using strong bots;
 - `Serpent.AI <https://github.com/SerpentAI/SerpentAI>`_, a Game Agent Framework;
 
 Learning