Fixed and extended docstrings

Author: michalpokusa

adafruit_httpserver/headers.py

@@ -15,7 +15,7 @@
 
 class HTTPHeaders:
     """
-    A dict-like object for storing HTTP headers.
+    A dict-like class for storing HTTP headers.
 
     Allows access to headers using **case insensitive** names.
 

adafruit_httpserver/request.py

@@ -47,7 +47,11 @@ class HTTPRequest:
     """
 
     raw_request: bytes
-    """Raw bytes passed to the constructor."""
+    """
+    Raw 'bytes' passed to the constructor and body 'bytes' received later.
+
+    Should **not** be modified directly.
+    """
 
     def __init__(self, raw_request: bytes = None) -> None:
         self.raw_request = raw_request

adafruit_httpserver/server.py

@@ -211,9 +211,10 @@ def request_buffer_size(self, value: int) -> None:
     def socket_timeout(self) -> int:
         """
         Timeout after which the socket will stop waiting for more incoming data.
-        When exceeded, raises `OSError` with `errno.ETIMEDOUT`.
 
-        Default timeout is 0, which means socket is in non-blocking mode.
+        Must be set to positive integer or float. Default is 1 second.
+
+        When exceeded, raises `OSError` with `errno.ETIMEDOUT`.
 
         Example::