ADFA-5552: Move media-optimization writeup out of the tree

The savings report is a time-bound analysis, not evergreen docs — it goes in
the PR description instead, so it doesn't linger in main after merge. Keep an
evergreen pointer to the tool in the README (how to run it, no stale numbers).

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

Author: alexmmiller

MEDIA_OPTIMIZATION_REPORT.md

@@ -1 +1,18 @@
-# ADFA-ODT
+# ADFA-ODT
+
+## Optimizing database media
+
+`scripts/optimize_db_media.py` shrinks every image stored in a
+`documentation.db` in place — downscaling and re-compressing PNG/JPEG/GIF/WebP
+and minifying SVG, without changing any file's path, extension, or how pages
+reference it. It backs the database up first, only ever makes an image
+smaller, and handles both plain-Brotli and shared-dictionary databases as
+well as chunked (multi-row) media.
+
+```bash
+uv run --with-requirements requirements.txt scripts/optimize_db_media.py documentation.db --dry-run
+```
+
+Drop `--dry-run` to apply the changes. See the script's module docstring
+(`--help`) for the full list of tuning flags (`--max-width`, `--jpeg-quality`,
+etc.); it needs the `pngquant` and `brotli` CLIs on `PATH`.