[chore] improve docstrings a bit

CHANGELOG.md

@@ -3,7 +3,7 @@
 ## 0.9.0 (2019-XX-XX)
 
 - Added sample rate as class attribute, for setting sample rate class-wide, #11 by @aviramha
-- Added timer contextmanager for easily timing events, #12 by @aviramha
+- Added timer context manager for easily timing events, #12 by @aviramha
 - Added Python 3.8.* support, #7
 
 ## 0.8.0 (2019-11-03)

aiodogstatsd/client.py

@@ -40,13 +40,12 @@ def __init__(
         """
         Initialize a client object.
 
-        You can pass host and port of the DogStatsD server, namespace to prefix all
-        metric names, constant tags to attach to all metrics.
+        You can pass `host` and `port` of the DogStatsD server, `namespace` to prefix
+        all metric names, `constant_tags` to attach to all metrics.
 
-        Also, you can specify default read timeout which will be used to read messages
-        from an AsyncIO queue, and you can specify close timeout which will be used
-        as wait time for client closing.
-        sample_rate can be used for adjusting the frequency of stats sending.
+        Also, you can specify: `read_timeout` which will be used to read messages from
+        an AsyncIO queue; `close_timeout` which will be used as wait time for client
+        closing; `sample_rate` can be used for adjusting the frequency of stats sending.
         """
         self._host = host
         self._port = port
@@ -234,7 +233,7 @@ def timeit(
         sample_rate: Optional[typedefs.MSampleRate] = None,
     ) -> Iterator[None]:
         """
-        Context for easily timing methods
+        Context manager for easily timing methods.
         """
         loop = get_event_loop()
         started_at = loop.time()

aiodogstatsd/contrib/aiohttp.py

@@ -61,9 +61,10 @@ async def middleware(
         loop = get_event_loop()
         request_started_at = loop.time()
 
-        # By default response status is 500 because we don't want to write any logic
-        # for catching exceptions except exceptions which inherited from `web.HTTPException`.
-        # And also we will override response status in case of any successful handler execution.
+        # By default response status is 500 because we don't want to write any logic for
+        # catching exceptions except exceptions which inherited from
+        # `web.HTTPException`. And also we will override response status in case of any
+        # successful handler execution.
         response_status = cast(int, HTTPStatus.INTERNAL_SERVER_ERROR.value)
 
         try:
@@ -109,10 +110,10 @@ def _proceed_collecting(
 
 def _derive_request_path(request: web.Request) -> str:
     """
-    AIOHTTP has a lot of different route resources like DynamicResource and we need
-    to process them correctly to get a valid original request path, so if you found
-    an issue with the request path in your metrics then you need to go here and
-    extend deriving logic.
+    AIOHTTP has a lot of different route resources like DynamicResource and we need to
+    process them correctly to get a valid original request path, so if you found an
+    issue with the request path in your metrics then you need to go here and extend
+    deriving logic.
     """
     if isinstance(request.match_info.route.resource, DynamicResource):
         return request.match_info.route.resource.canonical