Big docs/testing cleanup

Author: ariebovenberg

CHANGELOG.md

@@ -1,4 +1,4 @@
-# 🚀 Changelog
+# Changelog
 
 ## 0.10.0 (2026-??-??)
 

Makefile

@@ -7,7 +7,6 @@ init:
 .PHONY: typecheck
 typecheck:
 	mypy pysrc/ tests/
-	pytest --mypy-ini-file=tests/mypy.ini typesafety/
 
 .PHONY: format
 format:
@@ -18,7 +17,7 @@ format:
 .PHONY: docs
 docs:
 	rm -f pysrc/whenever/*.so  # Presence of the rust extension breaks sphinx (TODO: a better workaround)
-	@touch docs/api.rst  # force rebuild of API docs: code changes aren't detected
+	rm -rf docs/_build/
 	make -C docs/ html
 
 .PHONY: check-readme

docs/Makefile

@@ -4,7 +4,7 @@
 # You can set these variables from the command line.
 SPHINXOPTS    =
 SPHINXBUILD   = sphinx-build
-SPHINXPROJ    = Quiz
+SPHINXPROJ    = Whenever
 SOURCEDIR     = .
 BUILDDIR      = _build
 
@@ -17,4 +17,4 @@ help:
 # Catch-all target: route all unknown targets to Sphinx using the new
 # "make mode" option.  $(O) is meant as a shortcut for $(SPHINXOPTS).
 %: Makefile
-	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)
+	@$(SPHINXBUILD) -M $@ "$(SOURCEDIR)" "$(BUILDDIR)" $(SPHINXOPTS) $(O)

docs/api.rst

@@ -0,0 +1,2 @@
+```{include} ../CHANGELOG.md
+```

docs/changelog.md

@@ -25,7 +25,6 @@
     "sphinx.ext.napoleon",
     "sphinx.ext.viewcode",
     "sphinx_copybutton",
-    "enum_tools.autoenum",
     "myst_parser",
 ]
 templates_path = ["_templates"]
@@ -34,14 +33,21 @@
     ".rst": "restructuredtext",
 }
 html_static_path = ["_static"]
+html_title = "Whenever"
 
 master_doc = "index"
 exclude_patterns = ["_build", "Thumbs.db", ".DS_Store"]
 myst_heading_anchors = 2
+myst_enable_extensions = [
+    "colon_fence",
+    "smartquotes",
+]
 
 # -- Options for HTML output ----------------------------------------------
 
-autodoc_member_order = "bysource"
+autodoc_default_options = {
+    "exclude-members": "__weakref__, __init__, __init_subclass__, __reduce__, __hash__, __repr__",
+}
 html_theme = "furo"
 highlight_language = "python3"
 pygments_style = "default"
@@ -50,3 +56,8 @@
     "python": ("https://docs.python.org/3", None),
 }
 toc_object_entries_show_parents = "hide"
+maximum_signature_line_length = 95
+# Awaiting https://github.com/sphinx-doc/sphinx/issues/14003
+# autodoc_type_aliases = {
+#     "_CalendarUnitPlural": "_CalendarUnitPlural",
+# }

docs/changelog.rst

@@ -0,0 +1,2 @@
+```{include} ../CONTRIBUTING.md
+```