docs: leave adoption.md out of the Sphinx build

The adoption census arrived on develop in #323 and this branch had been
touching it: moving a % comment out of its BibTeX block, because Pygments'
bibtex lexer rejects it and this branch sets fail_on_warning, and adding it to
the toctree so the rendered docs could reach it.

Stop doing both. adoption.md is now byte-identical to develop, its toctree
entry is gone, and it is listed in exclude_patterns so Sphinx does not read
it -- which is what keeps the warning-free build warning-free without editing
someone else's page. It stays maintained for reading on GitHub, where its
source links and pinned commit URLs belong anyway.

sphinx-build -W is clean and no page links into it, so nothing is left
dangling.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01YUq1vM4g82TkaX2jvLmuQc

Author: claude

doc/adoption.md

@@ -271,8 +271,6 @@ To cite the edition you read, pin it to a commit: open the file on GitHub and pr
 <kbd>y</kbd>, or run `git log -1 --format=%H -- doc/adoption.md` in a clone. Each edition's
 permalink is the commit that bumped its version in the changelog below.
 
-Replace `<commit>` below with the permalink of the edition you read.
-
 ```bibtex
 @techreport{libcachesim-adoption-census-2026,
   title       = {libCacheSim Adoption Census},
@@ -281,6 +279,7 @@ Replace `<commit>` below with the permalink of the edition you read.
   number      = {census v1.2.0},
   year        = {2026},
   month       = aug,
+  % replace <commit> with the permalink of the edition you read
   url         = {https://github.com/1a1a11a/libCacheSim/blob/<commit>/doc/adoption.md},
   note        = {Census date 2026-08-13}
 }

doc/conf.py

@@ -34,6 +34,11 @@
     # html_extra_path below so the <img> tags in the guides resolve.
     "plot",
     "assets",
+    # Maintained for reading on GitHub, where its source links and pinned
+    # commit URLs belong. Sphinx is not asked to render it, which also keeps
+    # the BibTeX block's % comment -- valid BibTeX that Pygments' lexer
+    # rejects -- from failing the warning-free build.
+    "adoption.md",
 ]
 
 # quickstart_traceAnalyzer.md embeds the plots with raw <img> tags, so the

doc/index.md

@@ -42,13 +42,6 @@ memory_usage_profiling
 debug
 ```
 
-```{toctree}
-:maxdepth: 1
-:caption: About
-
-adoption
-```
-
 ## Other resources
 
 * [Python binding](https://github.com/cacheMon/libCacheSim-python) — easier API access, `pip install libcachesim`