Many minor documentation enhancements

docs/source/api/client.rst

@@ -1,7 +1,11 @@
 Pyrogram Client
 ===============
 
-This is the Client class. It exposes high-level methods for an easy access to the API.
+You have entered the API Reference section where you can find detailed information about Pyrogram's API. The main Client
+class, all available methods and types, filters, handlers, decorators and bound-methods detailed descriptions can be
+found starting from this page.
+
+This page is about the Client class, which exposes high-level methods for an easy access to the API.
 
 .. code-block:: python
     :emphasize-lines: 1-3

docs/source/api/decorators.rst

@@ -6,7 +6,7 @@ deserve a dedicated page.
 
 Decorators are able to register callback functions for handling updates in a much easier and cleaner way compared to
 :doc:`Handlers <handlers>`; they do so by instantiating the correct handler and calling
-:meth:`~pyrogram.Client.add_handler`, automatically. All you need to do is adding the decorators on top of your
+:meth:`~pyrogram.Client.add_handler` automatically. All you need to do is adding the decorators on top of your
 functions.
 
 .. code-block:: python

docs/source/api/handlers.rst

@@ -2,10 +2,7 @@ Update Handlers
 ===============
 
 Handlers are used to instruct Pyrogram about which kind of updates you'd like to handle with your callback functions.
-
 For a much more convenient way of registering callback functions have a look at :doc:`Decorators <decorators>` instead.
-In case you decided to manually create a handler, use :class:`~pyrogram.Client.add_handler` to register
-it.
 
 .. code-block:: python
     :emphasize-lines: 1, 10

docs/source/api/methods.rst

@@ -1,7 +1,7 @@
 Available Methods
 =================
 
-All Pyrogram methods listed here are bound to a :class:`~pyrogram.Client` instance.
+This page is about Pyrogram methods. All the methods listed here are bound to a :class:`~pyrogram.Client` instance.
 
 .. code-block:: python
     :emphasize-lines: 6

docs/source/api/types.rst

@@ -1,7 +1,7 @@
 Available Types
 ===============
 
-All Pyrogram types listed here are accessible through the main package directly.
+This page is about Pyrogram types. All types listed here are accessible through the main package directly.
 
 .. code-block:: python
     :emphasize-lines: 1