Updated documentation for the sponsorship changes.

Author: mrbiggred

AGENTS.md

@@ -11,6 +11,13 @@ Weekly Dev Chat website — MkDocs Material static site. Read `mkdocs.yml` and r
 - Use `./create_post.sh` to scaffold a new post (calculates next Tuesday automatically).
 - **Multiple posts on the same date:** If a date folder already has an `index.md`, prefix the filename with a number and dash (e.g., `0-index.md`). The newest/latest post should use the lowest number so it appears first on the homepage. The original `index.md` keeps its name.
 
+## Sponsors
+
+- Sponsor data lives in `data/sponsors.yml` (loaded via the `mkdocs-macros` plugin). The file's header comment documents the schema and consent policy.
+- Sponsor logos go in `docs/assets/sponsors/`. Reference them with just the filename in the `image:` field.
+- Optimize logos with `python3 scripts/optimize_image.py <path>` before committing.
+- The page itself is `docs/sponsors/index.md`; styles are in `docs/stylesheets/sponsors.css`.
+
 ## Guardrails
 
 - Pushing to `main` triggers automatic deployment to production. Do not push without explicit approval.

README.md

@@ -175,7 +175,7 @@ This script requires `pyyaml`, which is included in `requirements.txt`. It is al
 
 ## Updating Sponsors
 
-Sponsor and donor entries live in [`data/sponsors.yml`](data/sponsors.yml), which is loaded into the sponsors page via the [`mkdocs-macros`](https://mkdocs-macros-plugin.readthedocs.io/) plugin. The file's header comment documents the schema, consent policy, and how to reference one sponsor across multiple years. Place sponsor logos in `docs/sponsors/` and reference the filename via the `image:` field.
+Sponsor and donor entries live in [`data/sponsors.yml`](data/sponsors.yml), which is loaded into the sponsors page via the [`mkdocs-macros`](https://mkdocs-macros-plugin.readthedocs.io/) plugin. The file's header comment documents the schema, consent policy, and how to reference one sponsor across multiple years. Place sponsor logos in `docs/assets/sponsors/` and reference the filename via the `image:` field (e.g. `image: example.png` → `docs/assets/sponsors/example.png`). Optimize logos with `python3 scripts/optimize_image.py` before committing.
 
 ## Project Structure
 
@@ -205,9 +205,10 @@ Sponsor and donor entries live in [`data/sponsors.yml`](data/sponsors.yml), whic
     ├── tags.md                # Tags index page (auto-populated by tags plugin)
     ├── hosts/                 # Current hosts
     ├── past-hosts/            # Past hosts
-    ├── sponsors/              # Sponsors
+    ├── sponsors/              # Sponsors page (index.md)
     ├── posts/                 # Blog posts (YYYY/MM/DD/)
     ├── assets/                # Images, logos
+    │   └── sponsors/          # Sponsor logos (referenced by data/sponsors.yml)
     └── stylesheets/
         ├── extra.css          # Site-wide custom CSS
         └── sponsors.css       # Sponsors page styling