Merge branch 'main' into 40c3

README.md

@@ -149,3 +149,19 @@ The uMap data has been converted into this format in [data/schedule/39c3.yaml](d
 - The whole map: the "Download" option in uMap's share panel exports all layers as one GeoJSON file.
 
 In the GeoJSON, `coordinates` are already in `[lon, lat]` order, the colour and icon are in each feature's `properties._umap_options`, and the directions are in `properties.description`.
+
+## Accessibility check
+
+CI runs [pa11y-ci](https://github.com/pa11y/pa11y-ci) with the axe and HTML_CodeSniffer rules for WCAG 2 AA on every push and pull request, in its own job (`accessibility`), so findings show up without blocking the deploy. To run the same check locally (needs Node.js, Python 3 and Chrome or Chromium):
+
+```shell
+./scripts/pa11y.sh
+```
+
+The script builds the site, serves it on `localhost:8080` and checks every page in the sitemaps, except the past events and the individual news posts, which are kept as they were. The list of skipped sections is `EXCLUDE` in [scripts/pa11y.sh](scripts/pa11y.sh); the rules are in [.pa11yci.json](.pa11yci.json). pa11y only checks the light colour scheme.
+
+Some things to keep in mind when writing pages:
+
+- Give every image an alt text that says what it shows. The image title is the photo credit (`![Alt text](photo.jpg "© Photographer")`); it is shown below the image.
+- Headings in a page start at `##`; `#` is the page title.
+- Don't put information only into images, like directions on a map; write it out as text as well.