Modernize attribute docs

Place the documentation on the attributes directly. This was not
previously possible due to how the attributes were constructed. This
also allows us to eliminate duplicate documentation for inherited
attributes.

Author: oschwald

docs/index.rst

@@ -14,21 +14,33 @@ Modules
 
 .. automodule:: geoip2
     :members:
+    :inherited-members:
+    :show-inheritance:
 
 .. automodule:: geoip2.database
     :members:
+    :inherited-members:
+    :show-inheritance:
 
 .. automodule:: geoip2.webservice
     :members:
+    :inherited-members:
+    :show-inheritance:
 
 .. automodule:: geoip2.models
     :members:
+    :inherited-members:
+    :show-inheritance:
 
 .. automodule:: geoip2.records
     :members:
+    :inherited-members:
+    :show-inheritance:
 
 .. automodule:: geoip2.errors
     :members:
+    :inherited-members:
+    :show-inheritance:
 
 ==================
 Indices and tables

geoip2/errors.py

@@ -19,26 +19,12 @@ class GeoIP2Error(RuntimeError):
 
 
 class AddressNotFoundError(GeoIP2Error):
-    """The address you were looking up was not found.
-
-    .. attribute:: ip_address
-
-      The IP address used in the lookup. This is only available for database
-      lookups.
-
-      :type: str
-
-    .. attribute:: network
-
-      The network associated with the error. In particular, this is the
-      largest network where no address would be found. This is only
-      available for database lookups.
-
-      :type: ipaddress.IPv4Network or ipaddress.IPv6Network
-
-    """
+    """The address you were looking up was not found."""
 
     ip_address: Optional[str]
+    """The IP address used in the lookup. This is only available for database
+    lookups.
+    """
     _prefix_len: Optional[int]
 
     def __init__(
@@ -53,7 +39,11 @@ def __init__(
 
     @property
     def network(self) -> Optional[Union[ipaddress.IPv4Network, ipaddress.IPv6Network]]:
-        """The network for the error."""
+        """The network associated with the error.
+
+        In particular, this is the largest network where no address would be
+        found. This is only available for database lookups.
+        """
         if self.ip_address is None or self._prefix_len is None:
             return None
         return ipaddress.ip_network(f"{self.ip_address}/{self._prefix_len}", False)
@@ -69,12 +59,15 @@ class HTTPError(GeoIP2Error):
     This class represents an HTTP transport error. It extends
     :py:exc:`GeoIP2Error` and adds attributes of its own.
 
-    :ivar http_status: The HTTP status code returned
-    :ivar uri: The URI queried
-    :ivar decoded_content: The decoded response content
-
     """
 
+    http_status: Optional[int]
+    """The HTTP status code returned"""
+    uri: Optional[str]
+    """The URI queried"""
+    decoded_content: Optional[str]
+    """The decoded response content"""
+
     def __init__(
         self,
         message: str,