From b0132498ba4a39f3932c23347bd9d3770478ffe6 Mon Sep 17 00:00:00 2001
From: Jens Tirsvad Nielsen <jenstirsvad@gmail.com>
Date: Tue, 13 Oct 2026 15:41:11 +0800
Subject: [PATCH] Fix Doxygen warnings: document the source only, with a main
 page

Refs #17
---
 Doxyfile          | 39 +++++++++++++++++++--------------------
 docs/mainpage.dox | 13 +++++++++++++
 2 files changed, 32 insertions(+), 20 deletions(-)
 create mode 100644 docs/mainpage.dox

diff --git a/Doxyfile b/Doxyfile
index c900876..8f48536 100644
--- a/Doxyfile
+++ b/Doxyfile
@@ -1,20 +1,19 @@
-# Doxygen configuration for the squirrel census project.
-# Build the source documentation with: doxygen Doxyfile
-# Output goes to docs/doxygen/ (ignored by git). Everything not listed here
-# keeps the Doxygen default.
-
-PROJECT_NAME           = "Squirrel Census"
-PROJECT_BRIEF          = "Count squirrels by primary fur colour"
-PROJECT_NUMBER         = 0.1.0
-OUTPUT_DIRECTORY       = docs/doxygen
-INPUT                  = src README.md
-FILE_PATTERNS          = *.py *.md
-RECURSIVE              = YES
-USE_MDFILE_AS_MAINPAGE = README.md
-OPTIMIZE_OUTPUT_JAVA   = YES
-EXTRACT_ALL            = YES
-GENERATE_HTML          = YES
-GENERATE_LATEX         = NO
-QUIET                  = YES
-WARN_IF_UNDOCUMENTED   = YES
-WARN_AS_ERROR          = NO
+# Doxygen configuration for the squirrel census project.
+# Build the source documentation with: doxygen Doxyfile
+# Output goes to docs/doxygen/ (ignored by git). Everything not listed here
+# keeps the Doxygen default.
+
+PROJECT_NAME           = "Squirrel Census"
+PROJECT_BRIEF          = "Count squirrels by primary fur colour"
+PROJECT_NUMBER         = 0.1.0
+OUTPUT_DIRECTORY       = docs/doxygen
+INPUT                  = src docs/mainpage.dox
+FILE_PATTERNS          = *.py *.dox
+RECURSIVE              = YES
+OPTIMIZE_OUTPUT_JAVA   = YES
+EXTRACT_ALL            = YES
+GENERATE_HTML          = YES
+GENERATE_LATEX         = NO
+QUIET                  = YES
+WARN_IF_UNDOCUMENTED   = YES
+WARN_AS_ERROR          = NO
diff --git a/docs/mainpage.dox b/docs/mainpage.dox
new file mode 100644
index 0000000..d330f88
--- /dev/null
+++ b/docs/mainpage.dox
@@ -0,0 +1,13 @@
+/**
+@mainpage Squirrel Census
+
+Count the squirrels of the 2018 Central Park Squirrel Census by primary fur colour
+(Gray, Cinnamon, Black) and export the counts to `squirrel_count.csv`.
+
+The steps follow the Udemy "100 Days of Code" lecture of day 25: squirrel.census.read_csv,
+squirrel.census.count_by_fur_color, squirrel.census.build_summary and
+squirrel.census.write_csv. The command line entry point is squirrel.cli.main, started
+with `python -m squirrel`. Every literal is defined once in squirrel.constants.
+
+The package uses only the Python standard library.
+*/
-- 
2.54.0