Fix doc

Author: ArthurDanjou

docs/Makefile

@@ -1,17 +1,20 @@
 # Makefile for Krum documentation
 
-.PHONY: help html clean servedocs live watch
+.PHONY: help html build clean serve watch
 
 help:
 	@echo "Available targets:"
 	@echo "  html       - Build HTML documentation"
+	@echo "  build      - Build HTML documentation (alias for html)"
 	@echo "  clean      - Remove generated files"
 	@echo "  serve      - Build and serve static documentation"
 	@echo "  watch      - Watch for changes and serve (auto-rebuild)"
 
 html:
 	uv run sphinx-build -b html . _build/html
 
+build: html
+
 clean:
 	rm -rf _build
 

docs/_static/custom.css

@@ -16,4 +16,9 @@
 
 .bd-toc .page-toc + .sidebar-secondary-item {
     display: none;
+}
+
+/* Contributions Avatar */
+.sphinx-contributors img {
+    border-radius: 50%;
 }

docs/conf.py

@@ -6,11 +6,16 @@
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
 
+import importlib
 import os
 import sys
 
 sys.path.insert(0, os.path.abspath(".."))
 
+# Make krum submodules available as top-level imports for autodoc compatibility
+for _mod in ("aggregators", "attacks", "experiments", "native", "tools"):
+    sys.modules[_mod] = importlib.import_module(f"krum.{_mod}")
+
 project = "Krum, the Library"
 copyright = "2026"
 author = "Peva BLANCHARD, Arthur DANJOU, El-Mahdi EL-MHAMDI, Sébastien ROUAULT, Mohammed Ammar SAID"

docs/contributors.rst

@@ -3,9 +3,9 @@ Contributors
 
 The following people have contributed to Krum:
 
-.. container:: rounded-image
-    .. contributors:: calicarpa/krum
-        :avatars:
+.. contributors:: calicarpa/krum
+    :avatars:
+    :names:
 
 We are open to all contributions. Whether it is a bug fix, a new feature, or an improvement to the documentation, feel free to open a pull request or start a discussion on GitHub.
 

docs/how-to/add-dataset.rst

@@ -72,7 +72,7 @@ batching automatically.
        )
 
 Step 3 — Export in ``__all__``
------------------------------
+------------------------------
 
 List the builder function in ``__all__`` so the loader can discover it.
 

pyproject.toml

@@ -103,3 +103,8 @@ quote-style = "double"
 indent-style = "space"
 skip-magic-trailing-comma = false
 line-ending = "auto"
+
+[dependency-groups]
+dev = [
+    "sphinx-autobuild>=2024.10.3",
+]