|
| 1 | +# CLAUDE.md |
| 2 | + |
| 3 | +Quarto static website for the "Responsible Modelling" workshop (epidemiological modelling, LSHTM, March 2026). |
| 4 | + |
| 5 | +## Workshop background |
| 6 | +Epidemiological modelling is expanding in capacity and visibility (e.g. COVID-19), but professional norms for evaluation and ethical conduct are still forming. This workshop asks: what does responsible modelling look like in practice? |
| 7 | + |
| 8 | +The day is structured around two complementary angles: |
| 9 | +1. **Scientific responsibility** — technical evaluation of models (validity, assumptions, reproducibility). How do we assess model quality across contexts, from endemic disease programmes to real-time outbreak response? |
| 10 | +2. **Social responsibility** — the role of values, expertise, and judgement when models inform public health decisions. Modelling choices are value-laden (parameter selection, objective functions, uncertainty quantification, ensemble interpretation). Who counts as an expert, and what are modellers' ethical duties? |
| 11 | + |
| 12 | +Key intellectual threads (from organisers Kath Sherratt, Seb Funk, Erica Thompson): |
| 13 | +- Evaluation is central: both of model outputs (predictions, forecasts) and modelling processes |
| 14 | +- Expert judgement is unavoidable — the question is how to apply it well |
| 15 | +- Communication alone is not the answer; responsibility starts upstream in model designs |
| 16 | +- The goal is practical: identify what responsible practice looks like and how to embed it in training and workflows |
| 17 | + |
| 18 | +Intended outcomes: shared resources/examples for good practice, a network of interest, and groundwork toward integrating responsible modelling into training (e.g. MSc modules, short courses, UKHSA-specific development). |
| 19 | + |
| 20 | +Background references: Zotero library at https://www.zotero.org/groups/6153593/responsible_id_modelling |
| 21 | + |
| 22 | +### Workshop style |
| 23 | +Collaborative, ~50 participants, in a single room. Facilitation aims to use appropriate Liberating Structures techniques where relevant: https://www.liberatingstructures.com/ls/ |
| 24 | + |
| 25 | +## Commands |
| 26 | +- `quarto preview` — local dev server with live reload |
| 27 | +- `quarto render` — build the site to `_site/` |
| 28 | + |
| 29 | +## Structure |
| 30 | +- Root `.qmd` files — public website pages (index, schedule, register, about, resources) |
| 31 | +- `admin/` — internal planning docs (agenda, logistics, TODOs); excluded from rendering |
| 32 | +- `_quarto.yml` — site config, navbar, theme settings |
| 33 | +- `styles.css` — custom CSS |
| 34 | +- `_site/` — build output (gitignored) |
| 35 | + |
| 36 | +## Conventions |
| 37 | +- Pages are Quarto Markdown (`.qmd`), not plain `.md` |
| 38 | +- Navbar defined in `_quarto.yml` under `website.navbar.left` |
| 39 | +- Admin/planning files go in `admin/`, never rendered to the site |
| 40 | +- MIT License (Epiforecasts) |
| 41 | + |
| 42 | +## Deployment |
| 43 | +GitHub Actions (`.github/workflows/publish.yml`) auto-renders and publishes to GitHub Pages on push to `main`. Site URL: https://epiforecasts.io/responsible-modelling/ |
0 commit comments