Adjust docs

Author: domdfcoding

doc-source/api.rst

@@ -4,7 +4,7 @@ API Reference
 
 .. latex:vspace:: -20px
 
-.. autosummary-widths:: 7/16
+.. autosummary-widths:: 45/100
 
 .. automodule:: sphinx_pyproject
 	:member-order: bysource

doc-source/usage.rst

@@ -38,13 +38,27 @@ By passing :func:`globalns=globals() <globals>` to the class constructor, the ke
 .. note::
 
    At time of writing the "Poetry" tool does not support PEP 621. To enable a mode compatible with
-   the ``[tool.poetry]`` heading supply the argument ``style="poetry"``. For example:
+   the ``[tool.poetry]`` table supply the argument ``style="poetry"``. For example:
 
    .. code-block:: python
 
       config = SphinxConfig("../pyproject.toml", style="poetry")
 
 
+Additionally the ``SphinxConfig`` class takes an optional parameter ``config_overrides`` that
+can be used to dynamically update values from ``pyproject.toml``. This can be helpful for setting
+dynamic values like ``version``.
+
+.. code-block:: python3
+
+	# conf.py
+	from sphinx_pyproject import SphinxConfig
+
+	from myproject import __version__ as myproject_version
+
+	config = SphinxConfig("../pyproject.toml", globalns=globals(), config_overrides = {"version": myproject_version})
+
+
 Configuration
 ----------------
 

sphinx_pyproject/__init__.py

@@ -64,6 +64,9 @@ class SphinxConfig(Mapping[str, Any]):
 		By default, or if explicitly :py:obj:`None`, no config updates are performed.
 	:no-default config_overrides:
 
+	.. versionchanged:: 0.2.0  Added the ``style`` keyword argument.
+	.. versionchanged:: 0.3.0  Added the ``config_overrides`` keyword argument.
+
 	.. autosummary-widths:: 1/4
 	"""
 
@@ -191,10 +194,6 @@ def __len__(self) -> int:
 	def __iter__(self) -> Iterator[str]:
 		"""
 		Returns an iterator over the keys in the ``tool.sphinx-pyproject`` table.
-
-		:rtype:
-
-		.. latex:clearpage::
 		"""
 
 		yield from self._freeform
@@ -305,6 +304,7 @@ def parse(
 		:param config:
 		:param set_defaults: Has no effect in this class.
 		"""
+
 		if "authors" in config:
 			config["author"] = config.pop("authors")
 		elif "maintainers" in config: