[nstarman]

The docs had no logo or favicon; conf.py set neither. This gives them the cosmology-api organisation's mark, from its avatar: a hexagon holding three linked cubes, near-white (#f3f3f3) on slate (#303841). The cubes are drawn larger than on the avatar, so they stay legible at favicon size.

docs/_static/make_logo.py writes it:

uv run docs/_static/make_logo.py                     # docs/_static/favicon.svg
uv run docs/_static/make_logo.py --size 2048 big.png # a PNG, at any size

• SVG by default: 1.2 KB and sharp at any size. The script writes the SVG text directly, so the default needs no dependencies.
• Geometry: every shape is a pointy-topped hexagon about one centre. The outer hexagon's size, the links' hexagon (which holds a cube on every other corner) and the cubes' size and line widths are constants at the top of the script.
• PNG on request: rendered with resvg-py, declared in the script's PEP 723 header, so uv run fetches it.
• Docs: conf.py sets html_logo and html_favicon to _static/favicon.svg. html_static_path already includes _static.

Checked:

• The pre-commit hooks pass on the changed files; mypy excludes docs/.
• A local sphinx-build with the docs extra builds without warnings and puts the SVG in both the favicon link and the sidebar logo.
• Re-running the script reproduces the file, and it stays readable at 32 px.

🤖 Generated with Claude Code

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 100.00%. Comparing base (ed9fcdc) to head (896ffbf).

Additional details and impacted files

@@            Coverage Diff            @@
##              main      #145   +/-   ##
=========================================
  Coverage   100.00%   100.00%           
=========================================
  Files           14        14           
  Lines          314       314           
=========================================
  Hits           314       314           

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[Copilot]

Copilot review overview

🟢 Approval recommended

It is a self-contained, low-risk docs-only change whose output I verified reproduces exactly, with valid API usage and only one optional, non-blocking operational note.

Review effort: Balanced
Findings: 1

Open (1)

• Logo generator script is unintentionally published in docs · New

What changed in this PR

This PR gives the Sphinx documentation a logo and favicon, which were previously unset in conf.py. It adds a small, dependency-light Python script that draws the cosmology-api organisation's mark (a hexagon with three linked cubes, near-white on slate) and writes it as a compact SVG by default, with an optional PNG path rendered via resvg-py (declared in a PEP 723 inline-metadata header). The committed favicon.svg is the script's output and is wired into both the sidebar logo and the favicon.

Changes:

• Add docs/_static/make_logo.py, a self-contained generator that emits the logo as SVG (stdlib only) or PNG (--size, via resvg-py).
• Commit the generated docs/_static/favicon.svg (verified to be reproduced byte-for-byte by the script).
• Set html_logo and html_favicon in docs/conf.py to _static/favicon.svg.

File	Description
docs/​_static/​make_logo.py	New PEP 723 script that computes hexagon geometry and writes the logo as SVG (default) or PNG; verified to regenerate the committed SVG exactly.
docs/​_static/​favicon.svg	The committed logo/favicon asset produced by the script.
docs/​conf.py	Points html_logo and html_favicon at the new asset, reusing the existing html_static_path.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.