diff --git a/README.rst b/README.rst
@@ -88,6 +88,8 @@ The easiest way to install python-zeroconf is using pip::
 How do I use it?
 ================
 
+Here's how to discover services:
+
 .. code-block:: python
 
     from zeroconf import ServiceBrowser, ServiceListener, Zeroconf
@@ -120,6 +122,8 @@ How do I use it?
     If you want to customize that you need to specify ``interfaces`` argument when
     constructing ``Zeroconf`` object (see the code for details).
 
+To see which service types are present on the network, try:
+
 .. code-block:: python
 
     from zeroconf import ZeroconfServiceTypes

diff --git a/src/zeroconf/_cache.py b/src/zeroconf/_cache.py
@@ -66,6 +66,8 @@ def _remove_key(cache: _DNSRecordCacheType, key: _str, record: _DNSRecord) -> No
 
 
 class DNSCache:
+    """Store of received DNS records, indexed for fast lookup."""
+
     def __init__(self) -> None:
         self.cache: _DNSRecordCacheType = {}
         self._expire_heap: list[tuple[float, DNSRecord]] = []

diff --git a/src/zeroconf/_dns.py b/src/zeroconf/_dns.py
@@ -296,6 +296,8 @@ def __repr__(self) -> str:
 
 
 class DNSHinfo(DNSRecord):
+    """HINFO record carrying the host's cpu and os strings."""
+
     __slots__ = ("_hash", "cpu", "os")
 
     def __init__(

diff --git a/src/zeroconf/_protocol/incoming.py b/src/zeroconf/_protocol/incoming.py
@@ -235,6 +235,7 @@ def __repr__(self) -> str:
         )
 
     def _read_header(self) -> None:
+        """Unpack the fixed twelve byte message header."""
         offset = self.offset
         if offset + 12 > self._data_len:
             raise IncomingDecodeError(
@@ -251,6 +252,7 @@ def _read_header(self) -> None:
         self._num_additionals = buf[offset + 10] << 8 | buf[offset + 11]
 
     def _read_questions(self) -> None:
+        """Parse the question entries."""
         buf = self._buf
         questions = self._questions
         for _ in range(self._num_questions):

diff --git a/src/zeroconf/_services/info.py b/src/zeroconf/_services/info.py
@@ -252,6 +252,7 @@ def __init__(
 
     @property
     def name(self) -> str:
+        """Fully qualified name of this service instance."""
         return self._name
 
     @name.setter

diff --git a/src/zeroconf/_utils/ipaddress.py b/src/zeroconf/_utils/ipaddress.py
@@ -56,14 +56,17 @@ def __hash__(self) -> int:
 
     @property
     def is_link_local(self) -> bool:
+        """True for a link-local address."""
         return self._is_link_local
 
     @property
     def is_unspecified(self) -> bool:
+        """True for an unspecified address."""
         return self._is_unspecified
 
     @property
     def is_loopback(self) -> bool:
+        """True for a loopback address."""
         return self._is_loopback
 
 
@@ -90,14 +93,17 @@ def __hash__(self) -> int:
 
     @property
     def is_link_local(self) -> bool:
+        """True for a link-local address."""
         return self._is_link_local
 
     @property
     def is_unspecified(self) -> bool:
+        """True for an unspecified address."""
         return self._is_unspecified
 
     @property
     def is_loopback(self) -> bool:
+        """True for a loopback address."""
         return self._is_loopback