diff --git a/.copier-answers.yml b/.copier-answers.yml
index 3c48bac1..b709d322 100644
--- a/.copier-answers.yml
+++ b/.copier-answers.yml
@@ -1,5 +1,5 @@
 # Changes here will be overwritten by Copier.
-_commit: 1.11.6
+_commit: 1.11.15
 _src_path: gh:pawamoy/copier-uv
 author_email: dev@pawamoy.fr
 author_fullname: Timothée Mazzucotelli
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 53065d83..4e6fb131 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,14 @@ The format is based on [Keep a Changelog](http://keepachangelog.com/en/1.0.0/)
 and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
 <!-- insertion marker -->
+## [1.0.4](https://github.com/mkdocstrings/mkdocstrings/releases/tag/1.0.4) - 2026-04-15
+
+<small>[Compare with 1.0.3](https://github.com/mkdocstrings/mkdocstrings/compare/1.0.3...1.0.4)</small>
+
+### Bug Fixes
+
+- Add timeout when downloading inventories (10 seconds) ([3d1969a](https://github.com/mkdocstrings/mkdocstrings/commit/3d1969a279ea396792c682810d029503e48d8fcd) by Simon Lloyd). [Issue-819](https://github.com/mkdocstrings/mkdocstrings/issues/819)
+
 ## [1.0.3](https://github.com/mkdocstrings/mkdocstrings/releases/tag/1.0.3) - 2026-02-07
 
 <small>[Compare with 1.0.2](https://github.com/mkdocstrings/mkdocstrings/compare/1.0.2...1.0.3)</small>
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 78db50f2..82526a81 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -2,6 +2,8 @@
 
 Contributions are welcome, and they are greatly appreciated! Every little bit helps, and credit will always be given.
 
+**Please always create an issue before working on a new feature or a bug fix, so that we can discuss the implementation and make sure that your work will be merged.**
+
 ## Environment setup
 
 Nothing easier!
@@ -38,8 +40,7 @@ Run `make help` to see all the available actions!
 
 ## Tasks
 
-The entry-point to run commands and tasks is the `make` Python script, located in the `scripts` directory. Try running `make` to show the available commands and tasks. The *commands* do not need the Python dependencies to be installed,
-while the *tasks* do. The cross-platform tasks are written in Python, thanks to [duty](https://github.com/pawamoy/duty).
+The entry-point to run commands and tasks is the `make` Python script, located in the `scripts` directory. Try running `make` to show the available commands and tasks. The *commands* do not need the Python dependencies to be installed, while the *tasks* do. The cross-platform tasks are written in Python, thanks to [duty](https://github.com/pawamoy/duty).
 
 If you work in VSCode, we provide [an action to configure VSCode](https://pawamoy.github.io/copier-uv/work/#vscode-setup) for the project.
 
diff --git a/LICENSE b/LICENSE
index aa2449ff..6270ba3e 100644
--- a/LICENSE
+++ b/LICENSE
@@ -1,6 +1,6 @@
 ISC License
 
-Copyright (c) 2019, Timothée Mazzucotelli
+Copyright (c) 2019, Timothée Mazzucotelli and contributors
 
 Permission to use, copy, modify, and/or distribute this software for any
 purpose with or without fee is hereby granted, provided that the above
diff --git a/README.md b/README.md
index e28c653b..8ddfc16b 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 # mkdocstrings
 
 [![ci](https://github.com/mkdocstrings/mkdocstrings/workflows/ci/badge.svg)](https://github.com/mkdocstrings/mkdocstrings/actions?query=workflow%3Aci)
-[![documentation](https://img.shields.io/badge/docs-mkdocs-708FCC.svg?style=flat)](https://mkdocstrings.github.io/)
+[![documentation](https://img.shields.io/badge/docs-zensical-FF9100.svg?style=flat)](https://mkdocstrings.github.io/mkdocstrings/)
 [![pypi version](https://img.shields.io/pypi/v/mkdocstrings.svg)](https://pypi.org/project/mkdocstrings/)
 [![conda version](https://img.shields.io/conda/vn/conda-forge/mkdocstrings)](https://anaconda.org/conda-forge/mkdocstrings)
 [![gitter](https://img.shields.io/badge/matrix-chat-4DB798.svg?style=flat)](https://app.gitter.im/#/room/#mkdocstrings:gitter.im)
@@ -20,7 +20,7 @@ Come have a chat or ask questions on our [Gitter channel](https://gitter.im/mkdo
 - [**Language-agnostic:**](https://mkdocstrings.github.io/handlers/overview/)
   just like *MkDocs*, *mkdocstrings* is written in Python but is language-agnostic.
   It means you can use it with any programming language, as long as there is a
-  [**handler**](https://mkdocstrings.github.io/reference/handlers/base/) for it.
+  [**handler**](https://mkdocstrings.github.io/reference/api/#mkdocstrings.BaseHandler) for it.
   We currently have [handlers](https://mkdocstrings.github.io/handlers/overview/) for the
   [C](https://mkdocstrings.github.io/c/),
   [Crystal](https://mkdocstrings.github.io/crystal/),
@@ -142,7 +142,6 @@ See the [Usage](https://mkdocstrings.github.io/usage) section of the docs for mo
 
 <div id="silver-sponsors"><b>Silver sponsors</b><p>
 <a href="https://fastapi.tiangolo.com/"><img alt="FastAPI" src="https://raw.githubusercontent.com/tiangolo/fastapi/master/docs/en/docs/img/logo-margin/logo-teal.png" style="height: 200px; "></a><br>
-<a href="https://docs.pydantic.dev/latest/"><img alt="Pydantic" src="https://pydantic.dev/assets/for-external/pydantic_logfire_logo_endorsed_lithium_rgb.svg" style="height: 180px; "></a><br>
 </p></div>
 
 <div id="bronze-sponsors"><b>Bronze sponsors</b><p>
diff --git a/config/ruff.toml b/config/ruff.toml
index 95d92083..6cb05666 100644
--- a/config/ruff.toml
+++ b/config/ruff.toml
@@ -1,5 +1,6 @@
-target-version = "py39"
+target-version = "py310"
 line-length = 120
+output-format = "concise"
 
 [lint]
 exclude = [
diff --git a/config/ty.toml b/config/ty.toml
index 545856a3..97724fa8 100644
--- a/config/ty.toml
+++ b/config/ty.toml
@@ -1,2 +1,6 @@
 [src]
 exclude = ["tests/fixtures"]
+
+[terminal]
+error-on-warning = true
+output-format = "concise"
diff --git a/config/vscode/launch.json b/config/vscode/launch.json
index 5f3742be..6571bd99 100644
--- a/config/vscode/launch.json
+++ b/config/vscode/launch.json
@@ -23,11 +23,10 @@
             "name": "docs",
             "type": "debugpy",
             "request": "launch",
-            "module": "mkdocs",
+            "module": "zensical",
             "justMyCode": false,
             "args": [
                 "serve",
-                "-v"
             ]
         },
         {
diff --git a/config/vscode/settings.json b/config/vscode/settings.json
index 87ecd639..51587578 100644
--- a/config/vscode/settings.json
+++ b/config/vscode/settings.json
@@ -16,6 +16,7 @@
     "ruff.lint.args": [
         "--config=config/ruff.toml"
     ],
+    "ty.configurationFile": "config/ty.toml",
     "yaml.schemas": {
         "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml"
     },
diff --git a/docs/.overrides/partials/comments.html b/docs/.overrides/partials/comments.html
index cc341ba9..793b075c 100644
--- a/docs/.overrides/partials/comments.html
+++ b/docs/.overrides/partials/comments.html
@@ -1,5 +1,5 @@
 <!-- Giscus -->
-<!-- https://squidfunk.github.io/mkdocs-material/setup/adding-a-comment-system/#giscus-integration -->
+<!-- https://zensical.org/docs/setup/comment-system/#giscus-integration -->
 <div id="feedback" style="display: none;">
     <h2 id="__comments">Feedback</h2>
     <script src="https://giscus.app/client.js"
diff --git a/docs/.overrides/partials/path-item.html b/docs/.overrides/partials/path-item.html
deleted file mode 100644
index a9c95446..00000000
--- a/docs/.overrides/partials/path-item.html
+++ /dev/null
@@ -1,22 +0,0 @@
-{# Fix breadcrumbs for when mkdocs-section-index is used. #}
-{# See https://github.com/squidfunk/mkdocs-material/issues/7614. #}
-
-<!-- Render navigation link content -->
-{% macro render_content(nav_item) %}
-  <span class="md-ellipsis">
-    {{ nav_item.title }}
-  </span>
-{% endmacro %}
-
-<!-- Render navigation item -->
-{% macro render(nav_item, ref=nav_item) %}
-  {% if nav_item.is_page %}
-    <li class="md-path__item">
-      <a href="{{ nav_item.url | url }}" class="md-path__link">
-        {{ render_content(ref) }}
-      </a>
-    </li>
-  {% elif nav_item.children %}
-    {{ render(nav_item.children | first, ref) }}
-  {% endif %}
-{% endmacro %}
diff --git a/docs/css/apidocs.css b/docs/css/apidocs.css
new file mode 100644
index 00000000..35ec8f19
--- /dev/null
+++ b/docs/css/apidocs.css
@@ -0,0 +1,21 @@
+/* Mark external links as such. */
+a.external::after,
+a.autorefs-external::after {
+  /* https://primer.style/octicons/arrow-up-right-24 */
+  mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
+  -webkit-mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
+  content: ' ';
+
+  display: inline-block;
+  vertical-align: middle;
+  position: relative;
+
+  height: 1em;
+  width: 1em;
+  background-color: currentColor;
+}
+
+a.external:hover::after,
+a.autorefs-external:hover::after {
+  background-color: var(--md-accent-fg-color);
+}
diff --git a/docs/css/material.css b/docs/css/material.css
deleted file mode 100644
index 9e8c14a6..00000000
--- a/docs/css/material.css
+++ /dev/null
@@ -1,4 +0,0 @@
-/* More space at the bottom of the page. */
-.md-main__inner {
-  margin-bottom: 1.5rem;
-}
diff --git a/docs/css/mkdocstrings.css b/docs/css/mkdocstrings.css
deleted file mode 100644
index 3447549c..00000000
--- a/docs/css/mkdocstrings.css
+++ /dev/null
@@ -1,82 +0,0 @@
-/* Indentation. */
-div.doc-contents:not(.first) {
-  padding-left: 25px;
-  border-left: .05rem solid var(--md-typeset-table-color);
-}
-
-/* Mark external links as such. */
-a.external::after,
-a.autorefs-external::after {
-  /* https://primer.style/octicons/arrow-up-right-24 */
-  mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
-  -webkit-mask-image: url('data:image/svg+xml,<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18.25 15.5a.75.75 0 00.75-.75v-9a.75.75 0 00-.75-.75h-9a.75.75 0 000 1.5h7.19L6.22 16.72a.75.75 0 101.06 1.06L17.5 7.56v7.19c0 .414.336.75.75.75z"></path></svg>');
-  content: ' ';
-
-  display: inline-block;
-  vertical-align: middle;
-  position: relative;
-
-  height: 1em;
-  width: 1em;
-  background-color: currentColor;
-}
-
-a.external:hover::after,
-a.autorefs-external:hover::after {
-  background-color: var(--md-accent-fg-color);
-}
-
-/* Avoid breaking parameters name, etc. in table cells. */
-td code {
-  word-break: normal !important;
-}
-
-/* Hide parameters in ToC. */
-li.md-nav__item:has(> a[href*="("]) {
-  display: none;
-}
-
-/* Tree-like output for backlinks. */
-.doc-backlink-list {
-  --tree-clr: var(--md-default-fg-color);
-  --tree-font-size: 1rem;
-  --tree-item-height: 1;
-  --tree-offset: 1rem;
-  --tree-thickness: 1px;
-  --tree-style: solid;
-  display: grid;
-  list-style: none !important;
-}
-
-.doc-backlink-list li > span:first-child {
-  text-indent: .3rem;
-}
-.doc-backlink-list li {
-  padding-inline-start: var(--tree-offset);
-  border-left: var(--tree-thickness) var(--tree-style) var(--tree-clr);
-  position: relative;
-  margin-left: 0 !important;
-
-  &:last-child {
-    border-color: transparent;
-  }
-  &::before{
-    content: '';
-    position: absolute;
-    top: calc(var(--tree-item-height) / 2 * -1 * var(--tree-font-size) + var(--tree-thickness));
-    left: calc(var(--tree-thickness) * -1);
-    width: calc(var(--tree-offset) + var(--tree-thickness) * 2);
-    height: calc(var(--tree-item-height)  * var(--tree-font-size));
-    border-left: var(--tree-thickness) var(--tree-style) var(--tree-clr);
-    border-bottom: var(--tree-thickness) var(--tree-style) var(--tree-clr);
-  }
-  &::after{
-    content: '';
-    position: absolute;
-    border-radius: 50%;
-    background-color: var(--tree-clr);
-    top: calc(var(--tree-item-height) / 2 * 1rem);
-    left: var(--tree-offset) ;
-    translate: calc(var(--tree-thickness) * -1) calc(var(--tree-thickness) * -1);
-  }
-}
diff --git a/duties.py b/duties.py
index 974ed169..dfc81027 100644
--- a/duties.py
+++ b/duties.py
@@ -35,7 +35,7 @@ def pyprefix(title: str) -> str:
 def _get_changelog_version() -> str:
     changelog_version_re = re.compile(r"^## \[(\d+\.\d+\.\d+)\].*$")
     with Path(__file__).parent.joinpath("CHANGELOG.md").open("r", encoding="utf8") as file:
-        return next(filter(bool, map(changelog_version_re.match, file))).group(1)  # ty: ignore[invalid-argument-type]
+        return next(filter(bool, map(changelog_version_re.match, file))).group(1)  # ty: ignore[invalid-argument-type,unresolved-attribute]
 
 
 @duty
@@ -58,7 +58,7 @@ def check(ctx: Context) -> None:
 def check_quality(ctx: Context) -> None:
     """Check the code quality."""
     ctx.run(
-        tools.ruff.check(*PY_SRC_LIST, config="config/ruff.toml"),
+        tools.ruff.check(*PY_SRC_LIST, config="config/ruff.toml", color=True),
         title=pyprefix("Checking code quality"),
     )
 
@@ -66,10 +66,8 @@ def check_quality(ctx: Context) -> None:
 @duty(nofail=PY_VERSION == PY_DEV)
 def check_docs(ctx: Context) -> None:
     """Check if the documentation builds correctly."""
-    Path("htmlcov").mkdir(parents=True, exist_ok=True)
-    Path("htmlcov/index.html").touch(exist_ok=True)
     ctx.run(
-        tools.mkdocs.build(strict=True, verbose=True),
+        tools.zensical.build(strict=True),
         title=pyprefix("Building documentation"),
     )
 
@@ -109,7 +107,7 @@ def docs(ctx: Context, *cli_args: str, host: str = "127.0.0.1", port: int = 8000
         port: The port to serve the docs on.
     """
     ctx.run(
-        tools.mkdocs.serve(dev_addr=f"{host}:{port}").add_args(*cli_args),
+        tools.zensical.serve(dev_addr=f"{host}:{port}").add_args(*cli_args),
         title="Serving documentation",
         capture=False,
     )
@@ -118,8 +116,22 @@ def docs(ctx: Context, *cli_args: str, host: str = "127.0.0.1", port: int = 8000
 @duty
 def docs_deploy(ctx: Context) -> None:
     """Deploy the documentation to GitHub pages."""
-    os.environ["DEPLOY"] = "true"
-    ctx.run(tools.mkdocs.gh_deploy(remote_name="org-pages", force=True), title="Deploying documentation")
+    from ghp_import import ghp_import  # noqa: PLC0415
+
+    ctx.run(tools.zensical.build(), title="Building documentation site")
+    ctx.run(
+        ghp_import,
+        kwargs={
+            "srcdir": "site",
+            "mesg": "chore: Update documentation",
+            "push": True,
+            "force": True,
+            "remote": "org-pages",
+        },
+        title="Deploying site to GitHub Pages",
+        command="ghp-import site -r org-pages -fpm 'chore: Update documentation'",
+        pty=PTY,
+    )
 
 
 @duty
@@ -136,8 +148,8 @@ def format(ctx: Context) -> None:
 def build(ctx: Context) -> None:
     """Build source and wheel distributions."""
     ctx.run(
-        tools.build(),
-        title="Building source and wheel distributions",
+        ["uv", "build"],
+        title="Building distributions",
         pty=PTY,
     )
 
@@ -147,10 +159,10 @@ def publish(ctx: Context) -> None:
     """Publish source and wheel distributions to PyPI."""
     if not Path("dist").exists():
         ctx.run("false", title="No distribution files found")
-    dists = [str(dist) for dist in Path("dist").iterdir()]
+    dists = [str(dist) for dist in Path("dist").iterdir() if dist.suffix in (".gz", ".whl")]
     ctx.run(
         tools.twine.upload(*dists, skip_existing=True),
-        title="Publishing source and wheel distributions to PyPI",
+        title="Publishing distributions to PyPI",
         pty=PTY,
     )
 
diff --git a/mkdocs.yml b/mkdocs.yml
deleted file mode 100644
index 8423ce25..00000000
--- a/mkdocs.yml
+++ /dev/null
@@ -1,209 +0,0 @@
-site_name: "mkdocstrings"
-site_description: "Automatic documentation from sources, for MkDocs."
-site_url: "https://mkdocstrings.github.io/"
-repo_url: "https://github.com/mkdocstrings/mkdocstrings"
-repo_name: "mkdocstrings/mkdocstrings"
-site_dir: "site"
-watch: [mkdocs.yml, README.md, CONTRIBUTING.md, CHANGELOG.md, src/mkdocstrings]
-copyright: Copyright &copy; 2019 Timothée Mazzucotelli
-edit_uri: edit/main/docs/
-
-validation:
-  omitted_files: warn
-  absolute_links: warn
-  unrecognized_links: warn
-
-nav:
-- Home:
-  - Overview: index.md
-  - Changelog: changelog.md
-  - Credits: credits.md
-  - License: license.md
-- Usage:
-  - usage/index.md
-  - Theming: usage/theming.md
-  - Handlers: usage/handlers.md
-  - All handlers:
-    - C: https://mkdocstrings.github.io/c/
-    - Crystal: https://mkdocstrings.github.io/crystal/
-    - GitHub Actions: https://watermarkhu.nl/mkdocstrings-github/
-    - Python: https://mkdocstrings.github.io/python/
-    - Python (Legacy): https://mkdocstrings.github.io/python-legacy/
-    - MATLAB: https://watermarkhu.nl/mkdocstrings-matlab/
-    - Shell: https://mkdocstrings.github.io/shell/
-    - TypeScript: https://mkdocstrings.github.io/typescript/
-    - VBA: https://pypi.org/project/mkdocstrings-vba
-  - Guides:
-    - Recipes: recipes.md
-    - Troubleshooting: troubleshooting.md
-- API reference: reference/api.md
-- Development:
-  - Contributing: contributing.md
-  - Code of Conduct: code_of_conduct.md
-  - Coverage report: coverage.md
-- Author's website: https://pawamoy.github.io/
-
-theme:
-  name: material
-  logo: logo.svg
-  custom_dir: docs/.overrides
-  features:
-  - announce.dismiss
-  - content.action.edit
-  - content.action.view
-  - content.code.annotate
-  - content.code.copy
-  - content.tooltips
-  - navigation.footer
-  - navigation.instant.preview
-  - navigation.path
-  - navigation.sections
-  - navigation.tabs
-  - navigation.tabs.sticky
-  - navigation.top
-  - search.highlight
-  - search.suggest
-  - toc.follow
-  palette:
-  - media: "(prefers-color-scheme)"
-    toggle:
-      icon: material/brightness-auto
-      name: Switch to light mode
-  - media: "(prefers-color-scheme: light)"
-    scheme: default
-    primary: teal
-    accent: purple
-    toggle:
-      icon: material/weather-sunny
-      name: Switch to dark mode
-  - media: "(prefers-color-scheme: dark)"
-    scheme: slate
-    primary: black
-    accent: lime
-    toggle:
-      icon: material/weather-night
-      name: Switch to system preference
-
-extra_css:
-- css/style.css
-- css/material.css
-- css/mkdocstrings.css
-
-extra_javascript:
-- js/feedback.js
-
-markdown_extensions:
-- attr_list
-- admonition
-- callouts:
-    strip_period: false
-- footnotes
-- pymdownx.details
-- pymdownx.emoji:
-    emoji_index: !!python/name:material.extensions.emoji.twemoji
-    emoji_generator: !!python/name:material.extensions.emoji.to_svg
-- pymdownx.highlight:
-    pygments_lang_class: true
-- pymdownx.magiclink
-- pymdownx.snippets:
-    base_path: [!relative $config_dir]
-    check_paths: true
-- pymdownx.superfences
-- pymdownx.tabbed:
-    alternate_style: true
-    slugify: !!python/object/apply:pymdownx.slugs.slugify
-      kwds:
-        case: lower
-- pymdownx.tasklist:
-    custom_checkbox: true
-- pymdownx.tilde
-- toc:
-    permalink: "¤"
-
-plugins:
-- search
-- autorefs
-- markdown-exec
-- section-index
-- coverage
-- mkdocstrings:
-    handlers:
-      python:
-        inventories:
-        - https://docs.python.org/3/objects.inv
-        - https://installer.readthedocs.io/en/stable/objects.inv  # demonstration purpose in the docs
-        - https://mkdocstrings.github.io/autorefs/objects.inv
-        - https://www.mkdocs.org/objects.inv
-        - https://python-markdown.github.io/objects.inv
-        - https://jinja.palletsprojects.com/en/stable/objects.inv
-        - https://markupsafe.palletsprojects.com/en/stable/objects.inv
-        paths: [src]
-        options:
-          backlinks: tree
-          docstring_options:
-            ignore_init_summary: true
-          docstring_section_style: list
-          filters: ["!^_"]
-          heading_level: 1
-          inherited_members: true
-          merge_init_into_class: true
-          parameter_headings: true
-          separate_signature: true
-          show_root_heading: true
-          show_root_full_path: false
-          show_signature_annotations: true
-          show_source: true
-          show_symbol_type_heading: true
-          show_symbol_type_toc: true
-          signature_crossrefs: true
-          summary: true
-- llmstxt:
-    full_output: llms-full.txt
-    sections:
-      Usage:
-      - index.md
-      - usage/index.md
-      - usage/handlers.md
-      - usage/theming.md
-      - recipes.md
-      - troubleshooting.md
-      API:
-      - reference/api.md
-- git-revision-date-localized:
-    enabled: !ENV [DEPLOY, false]
-    enable_creation_date: true
-    type: timeago
-- redirects:
-    redirect_maps:
-      theming.md: usage/theming.md
-      handlers/overview.md: usage/handlers.md
-      reference/mkdocstrings.md: reference/api.md
-      reference/index.md: reference/api.md#mkdocstrings
-- minify:
-    minify_html: !ENV [DEPLOY, false]
-- typeset
-
-extra:
-  social:
-  - icon: fontawesome/brands/github
-    link: https://github.com/pawamoy
-  - icon: fontawesome/brands/mastodon
-    link: https://fosstodon.org/@pawamoy
-  - icon: fontawesome/brands/twitter
-    link: https://twitter.com/pawamoy
-  - icon: fontawesome/brands/gitter
-    link: https://gitter.im/mkdocstrings/community
-  - icon: fontawesome/brands/python
-    link: https://pypi.org/project/mkdocstrings/
-  analytics:
-    feedback:
-      title: Was this page helpful?
-      ratings:
-        - icon: material/emoticon-happy-outline
-          name: This page was helpful
-          data: 1
-          note: Thanks for your feedback!
-        - icon: material/emoticon-sad-outline
-          name: This page could be improved
-          data: 0
-          note: Let us know how we can improve this page.
diff --git a/pyproject.toml b/pyproject.toml
index f661a98b..9c722187 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -70,7 +70,7 @@ source-includes = [
     "share",
     "tests",
     "duties.py",
-    "mkdocs.yml",
+    "zensical.toml",
     "*.md",
     "LICENSE",
 ]
@@ -85,7 +85,6 @@ data = [
 
 [dependency-groups]
 maintain = [
-    "build>=1.2",
     "git-changelog>=2.5",
     "twine>=5.1",
     "yore>=0.3.3",
@@ -93,29 +92,24 @@ maintain = [
 ci = [
     "dirty-equals>=0.9",
     "duty>=1.6",
-    "ruff>=0.4",
+    "griffe>=2.0",
     "pytest>=8.2",
     "pytest-cov>=5.0",
     "pytest-randomly>=3.15",
     "pytest-xdist>=3.6",
+    "ruff>=0.4",
     "ty>=0.0.14",
     "types-markdown>=3.6",
     "types-pyyaml>=6.0",
 ]
  docs = [
+    "ghp-import>=2.1",
     "markdown-callouts>=0.4",
     "markdown-exec>=1.8",
-    "mkdocs>=1.6",
-    "mkdocs-coverage>=1.0",
-    "mkdocs-git-revision-date-localized-plugin>=1.2",
-    "mkdocs-llmstxt>=0.2",
-    "mkdocs-material>=9.5",
-    "mkdocs-minify-plugin>=0.8",
-    "mkdocs-redirects>=1.2.1",
-    "mkdocs-section-index>=0.3",
-    "mkdocstrings-python>=2.0",
+    "mkdocstrings[python]>=0.29",
     # YORE: EOL 3.10: Remove line.
     "tomli>=2.0; python_version < '3.11'",
+    "zensical>=0.0.21",
 ]
 
 [tool.uv]
diff --git a/scripts/gen_credits.py b/scripts/gen_credits.py
index 8e8a7bf8..e8712895 100644
--- a/scripts/gen_credits.py
+++ b/scripts/gen_credits.py
@@ -2,7 +2,6 @@
 
 from __future__ import annotations
 
-import os
 import sys
 from collections import defaultdict
 from collections.abc import Iterable
@@ -10,7 +9,6 @@
 from itertools import chain
 from pathlib import Path
 from textwrap import dedent
-from typing import Union
 
 from jinja2 import StrictUndefined
 from jinja2.sandbox import SandboxedEnvironment
@@ -22,14 +20,14 @@
 else:
     import tomli as tomllib
 
-project_dir = Path(os.getenv("MKDOCS_CONFIG_DIR", "."))
+project_dir = Path.cwd()
 with project_dir.joinpath("pyproject.toml").open("rb") as pyproject_file:
     pyproject = tomllib.load(pyproject_file)
 project = pyproject["project"]
 project_name = project["name"]
 devdeps = [dep for group in pyproject["dependency-groups"].values() for dep in group if not dep.startswith("-e")]
 
-PackageMetadata = dict[str, Union[str, Iterable[str]]]
+PackageMetadata = dict[str, str | Iterable[str]]
 Metadata = dict[str, PackageMetadata]
 
 
diff --git a/src/mkdocstrings/_internal/download.py b/src/mkdocstrings/_internal/download.py
index 2d8b25f1..52bf42f5 100644
--- a/src/mkdocstrings/_internal/download.py
+++ b/src/mkdocstrings/_internal/download.py
@@ -19,6 +19,9 @@
 # Regex pattern for an environment variable in the form ${ENV_VAR}.
 _ENV_VAR_PATTERN = re.compile(r"\$\{([A-Za-z_][A-Za-z0-9_]*)\}")
 
+# Timeout in seconds for downloading.
+_TIMEOUT = 10
+
 
 def _download_url_with_gz(url: str) -> bytes:
     url, auth_header = _extract_auth_from_url(url)
@@ -27,7 +30,7 @@ def _download_url_with_gz(url: str) -> bytes:
         url,
         headers={"Accept-Encoding": "gzip", "User-Agent": "mkdocstrings/0.15.0", **auth_header},
     )
-    with urllib.request.urlopen(req) as resp:  # noqa: S310
+    with urllib.request.urlopen(req, timeout=_TIMEOUT) as resp:  # noqa: S310
         content: BinaryIO = resp
         if "gzip" in resp.headers.get("content-encoding", ""):
             content = gzip.GzipFile(fileobj=resp)  # ty: ignore[invalid-assignment]
diff --git a/src/mkdocstrings/_internal/extension.py b/src/mkdocstrings/_internal/extension.py
index 4439d400..0722c539 100644
--- a/src/mkdocstrings/_internal/extension.py
+++ b/src/mkdocstrings/_internal/extension.py
@@ -432,7 +432,7 @@ def makeExtension(  # noqa: N802
     global _AUTOREFS  # noqa: PLW0603
     if _AUTOREFS is None:
         _AUTOREFS = AutorefsPlugin()
-        _AUTOREFS.config = AutorefsConfig()
+        _AUTOREFS.config = AutorefsConfig()  # ty:ignore[invalid-assignment]
         _AUTOREFS.config.resolve_closest = True
         _AUTOREFS.config.link_titles = "auto"
         _AUTOREFS.config.strip_title_tags = "auto"
diff --git a/src/mkdocstrings/_internal/handlers/base.py b/src/mkdocstrings/_internal/handlers/base.py
index 41d89da9..799c4499 100644
--- a/src/mkdocstrings/_internal/handlers/base.py
+++ b/src/mkdocstrings/_internal/handlers/base.py
@@ -178,7 +178,7 @@ def __init__(
         self.env.filters["convert_markdown"] = self.do_convert_markdown
         self.env.filters["heading"] = self.do_heading
         self.env.filters["any"] = do_any
-        self.env.globals["log"] = get_template_logger(self.name)
+        self.env.globals["log"] = get_template_logger(self.name)  # ty:ignore[invalid-assignment]
 
     @property
     def md(self) -> Markdown:
diff --git a/src/mkdocstrings/_internal/loggers.py b/src/mkdocstrings/_internal/loggers.py
index 29f620a3..6c8817ac 100644
--- a/src/mkdocstrings/_internal/loggers.py
+++ b/src/mkdocstrings/_internal/loggers.py
@@ -5,12 +5,12 @@
 import logging
 from contextlib import suppress
 from pathlib import Path
-from typing import TYPE_CHECKING, Any, Callable
+from typing import TYPE_CHECKING, Any
 
 from jinja2 import pass_context
 
 if TYPE_CHECKING:
-    from collections.abc import MutableMapping, Sequence
+    from collections.abc import Callable, MutableMapping, Sequence
 
     from jinja2.runtime import Context
 
diff --git a/src/mkdocstrings/_internal/plugin.py b/src/mkdocstrings/_internal/plugin.py
index 2e7a8d39..4f9bd29d 100644
--- a/src/mkdocstrings/_internal/plugin.py
+++ b/src/mkdocstrings/_internal/plugin.py
@@ -161,7 +161,7 @@ def on_config(self, config: MkDocsConfig) -> MkDocsConfig | None:
         except KeyError:
             # Otherwise, add a limited instance of it that acts only on what's added through `register_anchor`.
             autorefs = AutorefsPlugin()
-            autorefs.config = AutorefsConfig()
+            autorefs.config = AutorefsConfig()  # ty:ignore[invalid-assignment]
             autorefs.scan_toc = False
             config.plugins["autorefs"] = autorefs
             _logger.debug("Added a subdued autorefs instance %r", autorefs)
@@ -199,7 +199,7 @@ def plugin_enabled(self) -> bool:
     @event_priority(50)  # Early, before autorefs' starts applying cross-refs and collecting backlinks.
     def _on_env_load_inventories(self, env: Environment, config: MkDocsConfig, *args: Any, **kwargs: Any) -> None:  # noqa: ARG002
         if self.plugin_enabled and self._handlers:
-            register = config.plugins["autorefs"].register_url  # ty: ignore[possibly-missing-attribute]
+            register = config.plugins["autorefs"].register_url  # ty: ignore[unresolved-attribute]
             for identifier, url in self._handlers._yield_inventory_items():
                 register(identifier, url)
 
diff --git a/tests/conftest.py b/tests/conftest.py
index 0c9a89ad..a2a40652 100644
--- a/tests/conftest.py
+++ b/tests/conftest.py
@@ -33,7 +33,7 @@ def fixture_mkdocs_conf(request: pytest.FixtureRequest, tmp_path: Path) -> Itera
         **getattr(request, "param", {}),
     }
     # Re-create it manually as a workaround for https://github.com/mkdocs/mkdocs/issues/2289
-    mdx_configs: dict[str, Any] = dict(ChainMap(*conf_dict.get("markdown_extensions", [])))  # ty: ignore[invalid-argument-type]
+    mdx_configs: dict[str, Any] = dict(ChainMap(*conf_dict.get("markdown_extensions", [])))  # ty: ignore[invalid-argument-type,invalid-assignment]
 
     conf.load_dict(conf_dict)
     assert conf.validate() == ([], [])
diff --git a/tests/test_api.py b/tests/test_api.py
index 0d714f0a..7ae732cb 100644
--- a/tests/test_api.py
+++ b/tests/test_api.py
@@ -141,7 +141,7 @@ def test_api_matches_inventory(inventory: Inventory, public_objects: list[griffe
         for obj in public_objects
         if obj.name not in ignore_names and obj.path not in inventory
     ]
-    msg = "Objects not in the inventory (try running `make run mkdocs build`):\n{paths}"
+    msg = "Objects not in the inventory (try running `make run zensical build --clean`):\n{paths}"
     assert not not_in_inventory, msg.format(paths="\n".join(sorted(not_in_inventory)))
 
 
@@ -164,7 +164,7 @@ def test_inventory_matches_api(
 
             if obj.path not in public_api_paths and not any(path in public_api_paths for path in obj.aliases):
                 not_in_api.append(item.name)
-    msg = "Inventory objects not in public API (try running `make run mkdocs build`):\n{paths}"
+    msg = "Inventory objects not in public API (try running `make run zensical build --clean`):\n{paths}"
     assert not not_in_api, msg.format(paths="\n".join(sorted(not_in_api)))
 
 
diff --git a/tests/test_extension.py b/tests/test_extension.py
index 6ba8adc1..5b031842 100644
--- a/tests/test_extension.py
+++ b/tests/test_extension.py
@@ -154,7 +154,7 @@ def test_use_custom_handler(ext_markdown: Markdown) -> None:
 
 def test_register_every_identifier_alias(plugin: MkdocstringsPlugin, ext_markdown: Markdown) -> None:
     """Assert that we don't preemptively register all identifiers of a rendered object."""
-    handler = plugin._handlers.get_handler("python")  # ty: ignore[possibly-missing-attribute]
+    handler = plugin._handlers.get_handler("python")  # ty: ignore[unresolved-attribute]
     ids = ("id1", "id2", "id3")
     handler.get_aliases = lambda _: ids  # ty: ignore[invalid-assignment]
     autorefs = ext_markdown.parser.blockprocessors["mkdocstrings"]._autorefs
diff --git a/tests/test_handlers.py b/tests/test_handlers.py
index fd9eb714..a1ef4ee6 100644
--- a/tests/test_handlers.py
+++ b/tests/test_handlers.py
@@ -62,7 +62,7 @@ def test_extended_templates(tmp_path: Path, plugin: MkdocstringsPlugin) -> None:
         tmp_path: Temporary folder.
         plugin: Instance of our plugin.
     """
-    handler = plugin._handlers.get_handler("python")  # ty: ignore[possibly-missing-attribute]
+    handler = plugin._handlers.get_handler("python")  # ty: ignore[unresolved-attribute]
 
     # monkeypatch Jinja env search path
     search_paths = [
diff --git a/zensical.toml b/zensical.toml
new file mode 100644
index 00000000..d04f4896
--- /dev/null
+++ b/zensical.toml
@@ -0,0 +1,214 @@
+[project]
+site_name = "mkdocstrings"
+site_description = "Automatic documentation from sources, for MkDocs."
+site_author = "Timothée Mazzucotelli"
+site_url = "https://mkdocstrings.github.io/mkdocstrings"
+repo_url = "https://github.com/mkdocstrings/mkdocstrings"
+repo_name = "mkdocstrings/mkdocstrings"
+copyright = "Copyright &copy; 2019 Timothée Mazzucotelli"
+extra_css = ["css/apidocs.css"]
+extra_javascript = ["js/feedback.js"]
+nav = [
+  { "Home" = [
+    { "Overview" = "index.md" },
+    { "Changelog" = "changelog.md" },
+    { "Credits" = "credits.md" },
+    { "License" = "license.md" },
+  ] },
+  { "Usage" = [
+    "usage/index.md",
+    { "Theming" = "usage/theming.md" },
+    { "Handlers" = "usage/handlers.md" },
+    { "All handlers" = [
+      { "C" = "https://mkdocstrings.github.io/c/" },
+      { "Crystal" = "https://mkdocstrings.github.io/crystal/" },
+      { "GitHub Actions" = "https://watermarkhu.nl/mkdocstrings-github/" },
+      { "Python" = "https://mkdocstrings.github.io/python/" },
+      { "Python (Legacy)" = "https://mkdocstrings.github.io/python-legacy/" },
+      { "MATLAB" = "https://watermarkhu.nl/mkdocstrings-matlab/" },
+      { "Shell" = "https://mkdocstrings.github.io/shell/" },
+      { "TypeScript" = "https://mkdocstrings.github.io/typescript/" },
+      { "VBA" = "https://pypi.org/project/mkdocstrings-vba" },
+    ] },
+    { "Guides" = [
+      { "Recipes" = "recipes.md" },
+      { "Troubleshooting" = "troubleshooting.md" },
+    ] },
+  ] },
+  { "API reference" = "reference/api.md" },
+  { "Development" = [
+    { "Contributing" = "contributing.md" },
+    { "Code of Conduct" = "code_of_conduct.md" },
+  ] },
+  { "Author's website" = "https://pawamoy.github.io" },
+]
+
+# ----------------------------------------------------------------------------
+# Theme configuration
+# ----------------------------------------------------------------------------
+[project.theme]
+logo = "logo.svg"
+custom_dir = "docs/.overrides"
+language = "en"
+features = [
+    "announce.dismiss",
+    "content.action.edit",
+    "content.action.view",
+    "content.code.annotate",
+    "content.code.copy",
+    "content.code.select",
+    "content.footnote.tooltips",
+    "content.tabs.link",
+    "content.tooltips",
+    "navigation.footer",
+    "navigation.indexes",
+    "navigation.instant",
+    "navigation.instant.prefetch",
+    "navigation.path",
+    "navigation.sections",
+    "navigation.tabs",
+    "navigation.tabs.sticky",
+    "navigation.top",
+    "search.highlight",
+    "toc.follow",
+]
+
+[[project.theme.palette]]
+media = "(prefers-color-scheme)"
+toggle.icon = "material/brightness-auto"
+toggle.name = "Switch to light mode"
+
+[[project.theme.palette]]
+media = "(prefers-color-scheme: light)"
+scheme = "default"
+primary = "teal"
+accent = "purple"
+toggle.icon = "material/weather-sunny"
+toggle.name = "Switch to dark mode"
+
+[[project.theme.palette]]
+media = "(prefers-color-scheme: dark)"
+scheme = "slate"
+primary = "black"
+accent = "lime"
+toggle.icon = "material/weather-night"
+toggle.name = "Switch to system preference"
+
+[project.theme.icon]
+logo = "material/currency-sign"
+
+# ----------------------------------------------------------------------------
+# Social configuration
+# ----------------------------------------------------------------------------
+[[project.extra.social]]
+icon = "fontawesome/brands/github"
+link = "https://github.com/pawamoy"
+
+[[project.extra.social]]
+icon = "fontawesome/brands/mastodon"
+link = "https://fosstodon.org/@pawamoy"
+
+[[project.extra.social]]
+icon = "fontawesome/brands/twitter"
+link = "https://twitter.com/pawamoy"
+
+[[project.extra.social]]
+icon = "fontawesome/brands/gitter"
+link = "https://gitter.im/mkdocstrings/community"
+
+[[project.extra.social]]
+icon = "fontawesome/brands/python"
+link = "https://pypi.org/project/mkdocstrings/"
+
+[project.extra.analytics.feedback]
+title = "Was this page helpful?"
+
+[[project.extra.analytics.feedback.ratings]]
+icon = "material/emoticon-happy-outline"
+name = "This page was helpful"
+data = 1
+note = "Thank you for your feedback!"
+
+[[project.extra.analytics.feedback.ratings]]
+icon = "material/emoticon-sad-outline"
+name = "This page could be improved"
+data = 0
+note = "Let us know how we can improve this page."
+
+# ----------------------------------------------------------------------------
+# Markdown extensions configuration
+# ----------------------------------------------------------------------------
+[project.markdown_extensions.abbr]
+[project.markdown_extensions.admonition]
+[project.markdown_extensions.attr_list]
+[project.markdown_extensions.callouts]
+[project.markdown_extensions.def_list]
+[project.markdown_extensions.footnotes]
+[project.markdown_extensions.md_in_html]
+[project.markdown_extensions.toc]
+permalink = "¤"
+[project.markdown_extensions.pymdownx.arithmatex]
+generic = true
+[project.markdown_extensions.pymdownx.betterem]
+smart_enable = "all"
+[project.markdown_extensions.pymdownx.caret]
+[project.markdown_extensions.pymdownx.details]
+[project.markdown_extensions.pymdownx.emoji]
+emoji_generator = "zensical.extensions.emoji.to_svg"
+emoji_index = "zensical.extensions.emoji.twemoji"
+[project.markdown_extensions.pymdownx.highlight]
+[project.markdown_extensions.pymdownx.inlinehilite]
+[project.markdown_extensions.pymdownx.keys]
+[project.markdown_extensions.pymdownx.magiclink]
+[project.markdown_extensions.pymdownx.mark]
+[project.markdown_extensions.pymdownx.smartsymbols]
+[project.markdown_extensions.pymdownx.snippets]
+check_paths = true
+[project.markdown_extensions.pymdownx.superfences]
+[[project.markdown_extensions.pymdownx.superfences.custom_fences]]
+name = "python"
+class = "python"
+validator = "markdown_exec.validator"
+format = "markdown_exec.formatter"
+[project.markdown_extensions.pymdownx.tabbed]
+alternate_style = true
+[project.markdown_extensions.pymdownx.tasklist]
+custom_checkbox = true
+[project.markdown_extensions.pymdownx.tilde]
+[project.markdown_extensions.zensical.extensions.preview]
+configurations = [{targets.include = ["reference/api.md"]}]
+
+# ----------------------------------------------------------------------------
+# Plugins configuration
+# ----------------------------------------------------------------------------
+[project.plugins.mkdocstrings.handlers.python]
+paths = ["src"]
+inventories = [
+  "https://docs.python.org/3/objects.inv",
+  "https://installer.readthedocs.io/en/stable/objects.inv",  # demonstration purpose in the docs
+  "https://mkdocstrings.github.io/autorefs/objects.inv",
+  "https://www.mkdocs.org/objects.inv",
+  "https://python-markdown.github.io/objects.inv",
+  "https://jinja.palletsprojects.com/en/stable/objects.inv",
+  "https://markupsafe.palletsprojects.com/en/stable/objects.inv",
+]
+
+[project.plugins.mkdocstrings.handlers.python.options]
+backlinks = "tree"
+docstring_options = { "ignore_init_summary" = true }
+docstring_section_style = "list"
+filters = "public"
+heading_level = 1
+inherited_members = true
+merge_init_into_class = true
+parameter_headings = true
+separate_signature = true
+show_root_heading = true
+show_root_full_path = false
+show_signature_annotations = true
+show_source = true
+show_symbol_type_heading = true
+show_symbol_type_toc = true
+signature_crossrefs = true
+summary = true
+unwrap_annotated = true