site: landing redesign + ancillary pages + brand footer + URL sweep

[sunt05]

Summary

Reshapes the public landing surface (suews.io) around the editorial-scientific register documented in the new .impeccable.md design context (also linked from CLAUDE.md). Net result: a quietly-confident scientific-instrument landing rather than a SaaS product page, three new editorial subpages, accessibility hygiene throughout, a team masthead with ORCID / Scholar / ResearchGate links for every contributor we could verify, a sweep of stale doc URLs that 404 today, and a new publications topic filter that ties the landing's Research applications cards to filtered entries in the Sphinx publications pages.

Auto-deploy implication. master deploys to suews.io via pages-deploy.yml. Recommend reviewing locally (or on a Pages preview) before merging.

Commits (13)

Landing + design context

• docs: sweep stale /en/latest/ URLs to /stable/; fix Yiqing rename — 13 occurrences across README.md, SuPy modules, validation pipeline, plus a new project rule in .claude/rules/docs/conventions.md blocking the pattern in future PRs. acknowledgement.rst: Yuanyuan Liu → Yiqing Liu (the actual contributor).
• site: add team, funding, dependencies pages with shared subpage.css — three editorial subpages sharing a neutrally-named class system (.subpage-* / .entry-*).
• site(brand): adopt shared 4-link compact footer — brings /brand/* onto the Team · Funding · Dependencies · Brand footer used site-wide; also removes a previously-broken link to a non-existent showcase.html.
• site(landing): redesign with a11y, motion hygiene, two-tier resources — two-tier resource cards, UMEP copy tightened to "provides a GUI for SUEWS", compact footer, raised --text-muted contrast, global :focus-visible, full prefers-reduced-motion block, contour-ring pulse stopped, decorative gradients removed. Stats bar preserved — evidence over assertion.
• site: refresh subpage titles, reorganise funding, rehouse brand under shared chrome.

Team-page polish (added in review)

• site(team): rename .team-* classes to shared .subpage-*/.entry-* — bug fix. Page originally shipped with class names that subpage.css did not define; contributor cards were rendering with browser defaults. 16 classes remapped to match /funding/ and /dependencies/.
• site(docs): refresh site/README.md for the new pages, stylesheets, and footer.
• site(team): add ORCID links for five contributors (Matthew Paskin, Silvia Rognone, Vitor Lavor, Keisuke Nakao, Minttu P. Havu) — each verified by cross-checking ORCID record affiliation and publication topic against their SUEWS contribution area.
• site(team): add ORCID + current affiliation for Shiho Onomura — verified via expanded ORCID search (Tokyo City University) and Google Scholar (tcu.ac.jp email, Onomura-Grimmond-Lindberg 2015 paper). Affiliation updated to reflect her move from Gothenburg.
• site(team): link contributors without ORCID to Scholar / ResearchGate — Zhenkun Li (ResearchGate), Thomas Loridan (Scholar), Brian Offerle (Scholar). Each has no public ORCID (searched exhaustively) but maintains an active research profile; links carry a title attribute so the source is clear on hover / focus.
• site(team): add contribution line for Xiaoxiong Xie — traced via git log (TMY fix 2020, ERA5 units fix 2021) and four RSL/FAI-related issues opened 2022–2025. v2020a → present.

Publications topic filter

Ties the existing bib-keyword taxonomy in docs/source/assets/refs/refs-SUEWS.bib and refs-community.bib (controlled vocabulary: energy-balance, water-balance, radiation, storage-heat, anthropogenic-heat, building-energy, carbon-flux, model-infrastructure) to the landing's Research applications section, so readers can click a topic on suews.io and land on the Sphinx publications page pre-filtered to that slug.

• docs(publications): add topic-based chip filter to publication pages — new Sphinx extension _ext/publications_topic_annotate.py reads both bib files at builder-inited and, on doctree-resolved, stamps each rendered bibliography <li> with pub-entry + pub-kw-<slug> classes (scoped by bibliography_key.docname to avoid sphinxcontrib-bibtex's per-doc id2/id3 collisions). New client-side widget _static/publications-filter.{js,css} renders a chip row above each bibliography, supports multi-select union, syncs ?topic=<slug>[,<slug>] via history.replaceState, respects aria-pressed / focus rings / prefers-reduced-motion, and shows an empty-state line when no entries match. related_publications.rst and community_publications.rst get a single .. raw:: html mount above the existing .. bibliography:: block — the list stays as one deduplicated flat list, not duplicated across per-topic subsections.
• site: redesign landing Applications as slug-based cards linked to filtered publications — replaces the flat dot-bullet list with six .resource-card entries matching Resources visually. Each card is one bib slug with a paper count (9 papers, 10 papers, ...) drawn from the bib, and href="docs.suews.io/stable/related_publications.html?topic=<slug>". Accent tokens chosen to reflect the physical constituent of each topic (sky-blue for flux balance, water-blue for hydrology, sun-gold for radiation, energy-orange for anthropogenic heat, wave-blue for building energy, veg-green for carbon flux). The local-dev IIFE now also rewrites these hrefs to http://127.0.0.1:8000/... and prepends a gold LOCAL badge to the .card-meta line when running on localhost/127.0.0.1.

Contributor coverage on /team/

• Linked to ORCID (15): Grimmond, Ting Sun, Lindberg, Järvi, Ward, Omidvar, Blunn, Yiqing Liu, Xiaoxiong Xie, Paskin, Rognone, Lavor, Nakao, Havu, Onomura.
• Linked to Scholar / ResearchGate (3): Loridan, Offerle, Zhenkun Li — verified no public ORCID.
• Unlinked (1): Yihao Tang — no public ORCID; no verified Scholar profile found yet.

Verified before merge

• make test-smoke — 9 passed, 0 failed.
• Publications filter end-to-end: make docs builds without new warnings; both related_publications.html (9 chips, 33 entries) and community_publications.html (3 chips, 1 entry with both energy-balance + water-balance tags) render the chip row with correct counts; clicking a chip filters the flat list and updates the URL; direct load with ?topic=carbon-flux pre-activates the chip and shows the 3 matching entries.
• Localhost-rewriting JS in site/index.html is guarded by hostname === 'localhost' || '127.0.0.1'; production path stays at https://docs.suews.io, no dev banner, Applications cards route to docs.suews.io/stable/....
• prefers-reduced-motion block in base.css covers all subpages and the new chip hover transition (zero inline animation declarations).
• /en/latest/ sweep targeted only docs.suews.io host; other readthedocs hosts (supy.readthedocs.io, umep-docs.readthedocs.io) legitimately still use /en/latest/.

Test plan

• Local browse (python -m http.server from site/): landing renders with two-tier resources, dev banner on localhost, six slug-based Application cards each showing N papers + gold LOCAL badge, footer links resolve, theme toggle works.
• Subpage spot-check at /team/, /funding/, /dependencies/ — render correctly, footer matches, no console errors.
• Team page: 19 contributor cards render with the shared entry styling; linked names in accent colour; hover titles show "Google Scholar profile" / "ResearchGate profile" on the three non-ORCID links.
• Brand pages (/brand/, /brand/brand-workshop.html) still render with the new footer.
• OS-level prefers-reduced-motion: reduce toggle kills contour-ring effect, card reveal on landing, and chip hover transition on publications pages.
• Publications filter: make docs && make livehtml (or browse built HTML); chip row above each .. bibliography::, multi-select union works, URL ?topic=<slug>[,<slug>] round-trips correctly, "All" clears, empty-state shows when no matches.
• Landing → docs deep-link: click each of the six Application cards on localhost; lands on http://127.0.0.1:8000/related_publications.html?topic=<slug> with the matching chip active and list filtered.
• After merge: pages-deploy.yml green; https://suews.io/team/ etc. return 200; https://docs.suews.io 302→/stable/; Lighthouse a11y green.

Out of scope (follow-ups in .context/todos.md)

• Yihao Tang: no verified ORCID or Scholar profile; leave unlinked for now.
• Full CITATION.cff ↔ acknowledgement.rst reconciliation (per earlier decision, only the Yiqing rename was in scope).
• Funding page: Option A (project-led entries) redesign proposed but not yet implemented — grant column misalignment remains.
• Mobile breakpoint spot-check.
• Client-side multi-slug chip state on the publications page does not currently collapse to ?topic= when the full slug set is selected; minor cosmetic.

[github-actions]

CI Build Plan

Changed Files

Python source (4 files)

• src/supy/_check.py
• src/supy/_load.py
• src/supy/data_model/validation/pipeline/orchestrator.py
• src/supy/data_model/validation/pipeline/phase_b_rules/physics_rules.py

Utility modules (1 file)

• src/supy/util/_io.py

Documentation (10 files)

• docs/README.md
• docs/source/_ext/publications_topic_annotate.py
• docs/source/_static/publications-filter.css
• docs/source/_static/publications-filter.js
• docs/source/acknowledgement.rst
• docs/source/community_publications.rst
• docs/source/conf.py
• docs/source/related_publications.rst
• src/supy/data_model/validation/pipeline/orchestrator.py
• src/supy/data_model/validation/pipeline/phase_b_rules/physics_rules.py

Static site (10 files)

• site/README.md
• site/brand/brand-workshop.html
• site/brand/index.html
• site/css/base.css
• site/css/subpage.css
• site/css/tokens.css
• site/dependencies/index.html
• site/funding/index.html
• site/index.html
• site/team/index.html

Build Configuration

	Configuration
Platforms	Linux x86_64
Python	3.9
Test tier	standard (all except slow)
PR status	Ready (standard matrix)

Rationale

• Python source changed -> single-platform build
• Utility modules changed -> single-platform build

---

_{Updated by CI on each push. See path-filters.yml for category definitions.}

[github-actions]

Preview Deployed

Content	Preview URL
Site	https://suews.io/preview/pr-1313/
Docs	https://suews.io/preview/pr-1313/docs/

Note

This preview is ephemeral. It will be lost when:

• Another PR with site/ or docs/ changes is pushed
• Changes are merged to master
• A manual workflow dispatch runs

To restore, push any commit to this PR.