Bump the optional group with 13 updates

Bumps the optional group with 13 updates:

| Package | From | To |
| --- | --- | --- |
| [pydoclint](https://github.com/jsh9/pydoclint) | `0.3.2` | `0.3.9` |
| [isort](https://github.com/pycqa/isort) | `5.12.0` | `5.13.2` |
| [markdown](https://github.com/Python-Markdown/markdown) | `3.4.4` | `3.5.2` |
| [mkdocs-macros-plugin](https://github.com/fralau/mkdocs_macros_plugin) | `1.0.4` | `1.0.5` |
| [mkdocs-material](https://github.com/squidfunk/mkdocs-material) | `9.3.1` | `9.5.6` |
| [mkdocstrings[python]](https://github.com/mkdocstrings/mkdocstrings) | `0.23.0` | `0.24.0` |
| [frequenz-repo-config[lib]](https://github.com/frequenz-floss/frequenz-repo-config-python) | `0.7.5` | `0.8.0` |
| [mypy](https://github.com/python/mypy) | `1.5.1` | `1.8.0` |
| [types-markdown](https://github.com/python/typeshed) | `3.4.2.10` | `3.5.0.20240129` |
| [pylint](https://github.com/pylint-dev/pylint) | `3.0.2` | `3.0.3` |
| [frequenz-repo-config[extra-lint-examples]](https://github.com/frequenz-floss/frequenz-repo-config-python) | `0.7.5` | `0.8.0` |
| [pytest-mock](https://github.com/pytest-dev/pytest-mock) | `3.11.1` | `3.12.0` |
| [pytest-asyncio](https://github.com/pytest-dev/pytest-asyncio) | `0.21.1` | `0.23.4` |

Updates `pydoclint` from 0.3.2 to 0.3.9
- [Release notes](https://github.com/jsh9/pydoclint/releases)
- [Changelog](https://github.com/jsh9/pydoclint/blob/main/CHANGELOG.md)
- [Commits](jsh9/pydoclint@0.3.2...0.3.9)

Updates `isort` from 5.12.0 to 5.13.2
- [Release notes](https://github.com/pycqa/isort/releases)
- [Changelog](https://github.com/PyCQA/isort/blob/main/CHANGELOG.md)
- [Commits](PyCQA/isort@5.12.0...5.13.2)

Updates `markdown` from 3.4.4 to 3.5.2
- [Release notes](https://github.com/Python-Markdown/markdown/releases)
- [Changelog](https://github.com/Python-Markdown/markdown/blob/master/docs/changelog.md)
- [Commits](Python-Markdown/markdown@3.4.4...3.5.2)

Updates `mkdocs-macros-plugin` from 1.0.4 to 1.0.5
- [Release notes](https://github.com/fralau/mkdocs_macros_plugin/releases)
- [Changelog](https://github.com/fralau/mkdocs-macros-plugin/blob/master/CHANGELOG.md)
- [Commits](fralau/mkdocs-macros-plugin@v1.0.4...v1.0.5)

Updates `mkdocs-material` from 9.3.1 to 9.5.6
- [Release notes](https://github.com/squidfunk/mkdocs-material/releases)
- [Changelog](https://github.com/squidfunk/mkdocs-material/blob/master/CHANGELOG)
- [Commits](squidfunk/mkdocs-material@9.3.1...9.5.6)

Updates `mkdocstrings[python]` from 0.23.0 to 0.24.0
- [Release notes](https://github.com/mkdocstrings/mkdocstrings/releases)
- [Changelog](https://github.com/mkdocstrings/mkdocstrings/blob/main/CHANGELOG.md)
- [Commits](mkdocstrings/mkdocstrings@0.23.0...0.24.0)

Updates `frequenz-repo-config[lib]` from 0.7.5 to 0.8.0
- [Release notes](https://github.com/frequenz-floss/frequenz-repo-config-python/releases)
- [Changelog](https://github.com/frequenz-floss/frequenz-repo-config-python/blob/v0.8.0/RELEASE_NOTES.md)
- [Commits](frequenz-floss/frequenz-repo-config-python@v0.7.5...v0.8.0)

Updates `mypy` from 1.5.1 to 1.8.0
- [Changelog](https://github.com/python/mypy/blob/master/CHANGELOG.md)
- [Commits](python/mypy@v1.5.1...v1.8.0)

Updates `types-markdown` from 3.4.2.10 to 3.5.0.20240129
- [Commits](https://github.com/python/typeshed/commits)

Updates `pylint` from 3.0.2 to 3.0.3
- [Release notes](https://github.com/pylint-dev/pylint/releases)
- [Commits](pylint-dev/pylint@v3.0.2...v3.0.3)

Updates `frequenz-repo-config[extra-lint-examples]` from 0.7.5 to 0.8.0
- [Release notes](https://github.com/frequenz-floss/frequenz-repo-config-python/releases)
- [Changelog](https://github.com/frequenz-floss/frequenz-repo-config-python/blob/v0.8.0/RELEASE_NOTES.md)
- [Commits](frequenz-floss/frequenz-repo-config-python@v0.7.5...v0.8.0)

Updates `pytest-mock` from 3.11.1 to 3.12.0
- [Release notes](https://github.com/pytest-dev/pytest-mock/releases)
- [Changelog](https://github.com/pytest-dev/pytest-mock/blob/main/CHANGELOG.rst)
- [Commits](pytest-dev/pytest-mock@v3.11.1...v3.12.0)

Updates `pytest-asyncio` from 0.21.1 to 0.23.4
- [Release notes](https://github.com/pytest-dev/pytest-asyncio/releases)
- [Commits](pytest-dev/pytest-asyncio@v0.21.1...v0.23.4)

---
updated-dependencies:
- dependency-name: pydoclint
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: optional
- dependency-name: isort
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: optional
- dependency-name: markdown
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: optional
- dependency-name: mkdocs-macros-plugin
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: optional
- dependency-name: mkdocs-material
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: optional
- dependency-name: mkdocstrings[python]
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: optional
- dependency-name: frequenz-repo-config[lib]
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: optional
- dependency-name: mypy
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: optional
- dependency-name: types-markdown
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: optional
- dependency-name: pylint
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: optional
- dependency-name: frequenz-repo-config[extra-lint-examples]
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: optional
- dependency-name: pytest-mock
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: optional
- dependency-name: pytest-asyncio
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: optional
...

Signed-off-by: dependabot[bot] <[email protected]>

docs/_scripts/macros.py

@@ -27,10 +27,7 @@ def _slugify(text: str) -> str:
     Returns:
         The slugified text.
     """
-    # The type of the return value is not defined for the markdown library.
-    # Also for some reason `mypy` thinks the `toc` module doesn't have a
-    # `slugify_unicode` function, but it definitely does.
-    return toc.slugify_unicode(text, "-")  # type: ignore[attr-defined,no-any-return]
+    return toc.slugify_unicode(text, "-")
 
 
 def _hook_macros_plugin(env: macros.MacrosPlugin) -> None:

mkdocs.yml

@@ -100,7 +100,6 @@ plugins:
       alias_type: redirect
       canonical_version: latest
   - mkdocstrings:
-      custom_templates: templates
       default_handler: python
       handlers:
         python:

pyproject.toml

@@ -5,7 +5,7 @@
 requires = [
   "setuptools == 68.1.0",
   "setuptools_scm[toml] == 7.1.0",
-  "frequenz-repo-config[lib] == 0.7.5",
+  "frequenz-repo-config[lib] == 0.8.0",
 ]
 build-backend = "setuptools.build_meta"
 
@@ -42,41 +42,41 @@ dev-flake8 = [
   "flake8 == 6.1.0",
   "flake8-docstrings == 1.7.0",
   "flake8-pyproject == 1.2.3",  # For reading the flake8 config from pyproject.toml
-  "pydoclint == 0.3.2",
+  "pydoclint == 0.3.9",
   "pydocstyle == 6.3.0",
 ]
-dev-formatting = ["black == 23.9.1", "isort == 5.12.0"]
+dev-formatting = ["black == 23.9.1", "isort == 5.13.2"]
 dev-mkdocs = [
   "black == 23.9.1",
-  "Markdown==3.4.4",
+  "Markdown==3.5.2",
   "mike == 2.0.0",
   "mkdocs-gen-files == 0.5.0",
   "mkdocs-literate-nav == 0.6.1",
-  "mkdocs-macros-plugin == 1.0.4",
-  "mkdocs-material == 9.3.1",
-  "mkdocstrings[python] == 0.23.0",
-  "frequenz-repo-config[lib] == 0.7.5",
+  "mkdocs-macros-plugin == 1.0.5",
+  "mkdocs-material == 9.5.6",
+  "mkdocstrings[python] == 0.24.0",
+  "frequenz-repo-config[lib] == 0.8.0",
 ]
 dev-mypy = [
-  "mypy == 1.5.1",
-  "types-Markdown == 3.4.2.10",
+  "mypy == 1.8.0",
+  "types-Markdown == 3.5.0.20240129",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-client-common[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-noxfile = [
   "nox == 2023.4.22",
-  "frequenz-repo-config[lib] == 0.7.5",
+  "frequenz-repo-config[lib] == 0.8.0",
 ]
 dev-pylint = [
-  "pylint == 3.0.2",
+  "pylint == 3.0.3",
   # For checking the noxfile, docs/ script, and tests
   "frequenz-client-common[dev-mkdocs,dev-noxfile,dev-pytest]",
 ]
 dev-pytest = [
   "pytest == 7.4.2",
-  "frequenz-repo-config[extra-lint-examples] == 0.7.5",
-  "pytest-mock == 3.11.1",
-  "pytest-asyncio == 0.21.1",
+  "frequenz-repo-config[extra-lint-examples] == 0.8.0",
+  "pytest-mock == 3.12.0",
+  "pytest-asyncio == 0.23.4",
   "async-solipsism == 0.5",
 ]
 dev = [