Refactor sponsors page to load the sponsors from the yml data.

Author: mrbiggred

.plans/SPONSOR_PAGE_CHANGES.md

@@ -26,17 +26,12 @@ Use `mkdocs-macros-plugin` to load a YAML data file and render the sponsors page
 - **Deduplicated structure:** sponsor details live once in a top-level `sponsors` map keyed by ID. Year entries under `years:` reference sponsors by ID only, so a sponsor returning across multiple years appears exactly once in the source.
 - 2026 and 2025 corporate entries populated from the existing sponsors page. `individual: []` empty lists in both years — no placeholder donors committed.
 
-### 3. Rewrite the sponsors page template
-- Replace `docs/sponsors/index.md` with a Jinja2-templated version.
-- Top section: help/sponsorship info text (kept from current page). Decide whether to keep `SaturdayMP, the main Weekly Dev Chat sponsor` hardcoded or make it data-driven via a `primary_sponsor` field in the YAML. Hardcoded is fine for now — just call out the decision.
-- Iterate years newest-first with explicit sorting, not map iteration order:
-  ```jinja
-  {% for year in sponsors.years.keys() | sort(reverse=true) %}
-  ```
-- For each year: corporate sponsors section, then individual donors section. For each ID in the year's list, look up the full record from the top-level `sponsors` map (e.g. `sponsors.sponsors[id]`). Skip + log a warning on unknown IDs so a typo fails loudly rather than silently dropping a sponsor.
-- Each sponsor/donor shows: image (if present), name, and link (if present). Use Jinja conditionals so missing fields don't render broken `<img>` tags or empty links.
-- Add alt text (`alt="{{ s.name }}"`) to every image — the existing page uses `![]()` with no alt, which is an accessibility gap worth fixing here.
-- Style consistent with existing hosts/past-hosts pages (150px float-left images).
+### 3. Rewrite the sponsors page template ✅
+- Replaced `docs/sponsors/index.md` with a Jinja2-templated version that preserves the top help/sponsorship text (SaturdayMP kept hardcoded).
+- Years iterated newest-first via `sponsors.years.keys() | sort(reverse=true)`.
+- For each year: Corporate Sponsors section; Individual Donors section rendered only when the list is non-empty. IDs are looked up in the top-level `sponsors` map; unknown IDs render a visible `> **WARNING:** ...` blockquote so typos fail loudly.
+- Image, name, and link are each rendered behind a Jinja conditional — missing optional fields don't produce broken tags or empty links.
+- Alt text added to every image. 150px float-left style matches the hosts/past-hosts pages, with a `<div style="clear: both;">` after each entry so floats don't collide.
 
 ### 4. Privacy / consent check
 - Before listing any individual by name, confirm they've opted in. Worth flagging to Chris as a launch gate.

data/sponsors.yml

@@ -46,13 +46,18 @@ sponsors:
     link_label: Edmonton Unlimited
     description: Thanks to Edmonton Unlimited for providing a Meetup Link.
 
+  chris:
+    name: Chris
+    description: Thanks to Chris for being an individual donor.
+
 years:
   2026:
     corporate:
       - saturday-mp
       - dev-edmonton
       - edmonton-unlimited
-    individual: []
+    individual:
+      - chris
 
   2025:
     corporate:

docs/sponsors/index.md

@@ -6,29 +6,52 @@ hide:
 
 The best way you can help the Weekly Dev Chat is to attend the events as the kind, supportive, and respectful person you are. A close second is to share the Weekly Dev Chat with others who might benefit.
 
-We also need volunteers to help with a variety of tasks from helping with events, admin work, website maintenance, social media, etc. If you are interested in volunteering, please reach out to Chris via email at <chris.cumming@saturdaymp.com>.
+We also need volunteers to help with a variety of tasks from helping with events, admin work, website maintenance, social media, etc. If you are interested in volunteering, please reach out to Chris via email at <chris.cumming@saturdaymp.com>.
 
-The final way you can help is by sponsoring SaturdayMP, the main Weekly Dev Chat sponsor, via GitHub [sponsors](https://github.com/sponsors/saturdaymp). Saturday MP pays for Zoom, hosting, food for in real life (IRL) events, and other expenses.
+The final way you can help is by sponsoring SaturdayMP, the main Weekly Dev Chat sponsor, via GitHub [sponsors](https://github.com/sponsors/saturdaymp). Saturday MP pays for Zoom, hosting, food for in real life (IRL) events, and other expenses.
 
-If you have any other ideas for helping Weekly Dev Chat please give [Chris](mailto:chris.cumming@saturdaymp.com) a shout. Thank you for your help and support, it is much appreciated.
+If you have any other ideas for helping Weekly Dev Chat please give [Chris](mailto:chris.cumming@saturdaymp.com) a shout. Thank you for your help and support, it is much appreciated.
 
-Sponsors
---------
+{% for year in sponsors.years.keys() | sort(reverse=true) %}
+## {{ year }}
 
-![](smp.jpeg){: style="width:150px;float: left;padding-right: 10px;"}
+### Corporate Sponsors
 
-**Saturday Morning Productions**
+{% for id in sponsors.years[year].corporate %}
+{% if id in sponsors.sponsors %}
+{% set s = sponsors.sponsors[id] %}
+{% if s.image %}![{{ s.name }}]({{ s.image }}){: style="width:150px;float: left;padding-right: 10px;"}
+{% endif %}
+**{% if s.link %}[{{ s.name }}]({{ s.link }}){% else %}{{ s.name }}{% endif %}**
 
-Thanks to [Saturday MP](https://saturdaymp.com/) for providing hosting, Zoom, and more.
+{% if s.description %}{{ s.description }}{% endif %}
 
-![](devEd.png){: style="width:150px;float: left;padding-right: 10px;"}
+<div style="clear: both;"></div>
 
-**Dev Edmonton Society**
+{% else %}
+> **WARNING:** Unknown sponsor ID `{{ id }}` referenced in `{{ year }}` corporate list. Check `data/sponsors.yml` for a typo.
 
-Thanks to [DES](https://devedmonton.com/) for providing a Slack channel.
+{% endif %}
+{% endfor %}
 
-![](EdmontonUnlimited.jpeg){: style="width:150px;float: left;padding-right: 10px;"}
+{% if sponsors.years[year].individual %}
+### Individual Donors
 
-**Edmonton Unlimited**
+{% for id in sponsors.years[year].individual %}
+{% if id in sponsors.sponsors %}
+{% set s = sponsors.sponsors[id] %}
+{% if s.image %}![{{ s.name }}]({{ s.image }}){: style="width:150px;float: left;padding-right: 10px;"}
+{% endif %}
+**{% if s.link %}[{{ s.name }}]({{ s.link }}){% else %}{{ s.name }}{% endif %}**
 
-Thanks to [Edmonton Unlimited](https://edmontonunlimited.com/) for providing a [Meetup Link](https://edmontonunlimited.com/).
+{% if s.description %}{{ s.description }}{% endif %}
+
+<div style="clear: both;"></div>
+
+{% else %}
+> **WARNING:** Unknown donor ID `{{ id }}` referenced in `{{ year }}` individual list. Check `data/sponsors.yml` for a typo.
+
+{% endif %}
+{% endfor %}
+{% endif %}
+{% endfor %}

mkdocs.yml

@@ -43,6 +43,10 @@ nav:
 
 exclude_docs: |
     past_topics.md
+
+watch:
+  - data
+
 markdown_extensions:
   - attr_list  # This lets us specify image dimensions, etc.