release: v0.10.0 — reviewer-ready release

Post-merge consistency commit:

  * CITATION.cff version 0.9.0 → 0.10.0, date 2026-05-26
  * CHANGELOG.md — new "[0.10.0]" section listing all 13 commits
    that landed across PRs #17 / #18 / #19
  * Post-merge gate fixes:
      - doxygen_groups.h + doxygen_namespaces.h gain \\file briefs
      - .codespellrc extended (honour, thead, optimiser)
      - compile-time.md: unbalanced backtick on line 102 fixed
        (was confusing Doxygen's verbatim-block detector)

Final gate state on the merged main:
  ✅ 259/259 tests pass
  ✅ test-count consistency
  ✅ markdown links 166/166 resolve (43 .md files)
  ✅ CGAL conventions 0/8 violations
  ✅ license-headers 68/68 carry MIT SPDX
  ✅ codespell 0 typos
  ✅ shellcheck 0 findings (18 scripts)
  ✅ Doxygen 396/396 symbols, 0 warnings

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

doc/architecture/compile-time.md

@@ -99,7 +99,7 @@ The four candidate quick-wins from the prior analysis were:
    add a fragile maintenance burden (every Eigen version-bump would
    need re-verification of the explicit-instantiation list).  If a
    future Eigen update breaks the PCH, this is the next lever.
-3. **Header split** for `<CGAL/Discrete_conformal_map.h>** — separate
+3. **Header split** for `<CGAL/Discrete_conformal_map.h>` — separate
    into `_euclidean.h` / `_spherical.h` / `_hyper_ideal.h` so
    downstream consumers who only need one geometry pay less.
    **Deferred**: our test build pulls all three, so the gain is
@@ -232,19 +232,22 @@ Three issues defeat the hot rebuild:
 
 1. **PCH artefacts are not cached by default.** Apple clang's
    `-include-pch ...gch` path embeds timestamps that miss the cache
-   lookup.  Workaround: set `CCACHE_SLOPPINESS=pch_defines,
-   include_file_mtime,include_file_ctime,time_macros,file_macro,
-   system_headers` (tried; still 0 % hit on macOS).
+   lookup.  Workaround: set the environment variable
+   `CCACHE_SLOPPINESS` to
+   `pch_defines,include_file_mtime,include_file_ctime,time_macros,file_macro,system_headers`
+   (tried; still 0 % hit on macOS).
 2. **Unity Build .cxx files** have generated paths that change
    between configurations; ccache treats each as a fresh compile.
 3. **CMake's compile-launcher mechanism** doesn't currently combine
-   with `target_precompile_headers()` in a way that ccache 4.x
-   recognises on Apple clang.  Tracked upstream as a known issue.
+   with the `target_precompile_headers` CMake command in a way that
+   ccache 4.x recognises on Apple clang — known-issue upstream.
 
 **On Linux CI** the picture is different: g++ + traditional PCH +
 non-Apple toolchain typically delivers 80 %+ hit rates with ccache.
 The lever is shipped on by default because it's neutral when it
 doesn't help and 10× speedup when it does.
 
-To force-disable for clean from-scratch measurements, pass the
-CMake flag `-DCONFORMALLAB_USE_CCACHE=OFF` at configure time.
+To force-disable for clean from-scratch measurements, set the CMake
+cache variable **CONFORMALLAB_USE_CCACHE** to **OFF** at configure
+time.
+