Update docs.

Author: domdfcoding

doc-source/requirements.txt

@@ -2,6 +2,7 @@ git+https://github.com/sphinx-toolbox/sphinx-toolbox-experimental.git
 default-values>=0.5.0
 domdf-sphinx-theme>=0.3.0
 extras-require>=0.2.0
+html-section>=0.1.0
 pandas>=1.1.2
 pytest>=6.2.0
 pytest-regressions>=2.0.2

domdf_python_tools/utils.py

@@ -410,7 +410,10 @@ def head(obj: Union[Tuple, List, "DataFrame", "Series", String, HasHead], n: int
 	:param obj:
 	:param n: Show the first ``n`` items of ``obj``.
 
-	.. seealso:: :func:`textwrap.shorten`, which truncates a string to fit within a given number of characters.
+	.. seealso::
+
+		* :func:`textwrap.shorten`, which truncates a string to fit within a given number of characters.
+		* :func:`itertools.islice`, which returns the first ``n`` elements from an iterator.
 	"""
 
 	if isinstance(obj, tuple) and hasattr(obj, "_fields"):

pyproject.toml

@@ -63,9 +63,9 @@ extensions = [
     "sphinx_debuginfo",
     "sphinx_licenseinfo",
     "seed_intersphinx_mapping",
+    "html_section",
     "sphinx_autofixture",
     "sphinx_highlights",
-    "sphinx_toolbox_experimental.html_section",
     "sphinx_toolbox_experimental.needspace",
     "sphinx_toolbox_experimental.autosummary_widths",
     "sphinx_toolbox_experimental.succinct_seealso",

repo_helper.yml

@@ -66,7 +66,6 @@ mypy_deps:
 extra_sphinx_extensions:
  - sphinx_autofixture
  - sphinx_highlights
- - sphinx_toolbox_experimental.html_section
  - sphinx_toolbox_experimental.needspace
  - sphinx_toolbox_experimental.autosummary_widths
  - sphinx_toolbox_experimental.succinct_seealso