Improve docs layout

Author: domdfcoding

doc-source/api/pypi-json.rst

@@ -7,11 +7,15 @@
 	:no-members:
 	:autosummary-members:
 
+.. autosummary-widths:: 40/100
+
 .. autoclass:: pypi_json.PyPIJSON
 	:member-order: bysource
+	:no-show-inheritance:
 
 .. autonamedtuple:: pypi_json.ProjectMetadata
 	:member-order: bysource
+	:exclude-members: __repr__
 
 .. autovariable:: pypi_json.USER_AGENT
 	:no-value:

doc-source/api/typehints.rst

@@ -2,4 +2,5 @@
 :mod:`pypi_json.typehints`
 ============================
 
+.. autosummary-widths:: 35/100
 .. automodule:: pypi_json.typehints

pypi_json/__init__.py

@@ -67,6 +67,24 @@
 class ProjectMetadata(NamedTuple):
 	"""
 	Represents a project's metadata from the PyPI JSON API.
+
+	:param info: Generic information about a specific version of a project.
+
+	:bold-title:`Attributes:`
+
+	.. autosummary::
+
+		~pypi_json.ProjectMetadata.name
+		~pypi_json.ProjectMetadata.version
+
+	**Methods:**
+
+	.. autosummary::
+
+		~pypi_json.ProjectMetadata.get_latest_version
+		~pypi_json.ProjectMetadata.get_releases_with_digests
+		~pypi_json.ProjectMetadata.get_releases
+		~pypi_json.ProjectMetadata.get_wheel_tag_mapping
 	"""
 
 	#: Generic information about a specific version of a project.
@@ -206,6 +224,8 @@ class PyPIJSON:
 	:param session: Optional :class:`requests.Session` object to use instead of creating a fresh one.
 
 	.. _another authentication object accepted by requests: https://requests.readthedocs.io/en/master/user/authentication/
+
+	.. latex:clearpage::
 	"""
 
 	timeout: ClassVar[int] = 10

pypi_json/typehints.py

@@ -190,7 +190,7 @@ class DistributionPackageDict(TypedDict):
 
 class FileURL(TypedDict):
 	"""
-	:class:`typing.TypedDict` representing the output of
+	Represents the output of
 	:meth:`ProjectMetadata.get_releases_with_digests <pypi_json.ProjectMetadata.get_releases_with_digests>`.
 	"""  # noqa: D400