docs: move template behaviour to README; remove from CLAUDE.md

2026-06-21 11:10:24 +02:00
parent 461df550a1
commit 6d2723e6f2
2 changed files with 20 additions and 1 deletions
@@ -131,6 +131,26 @@ Plugins are not committed to git. The full list is in `plugins.txt` — one plug

 ---

+## Template behaviour
+
+Key design decisions that affect how pages render:
+
+| Context | Sort order | Reason |
+|---------|------------|--------|
+| Trip page (`trip.html.twig`) | Ascending (oldest first) | Trip reads as a narrative from start to finish |
+| Homepage active-trip feed (`home.html.twig`) | Descending (newest first) | Visitors want to see what's happening right now |
+
+**Homepage modes** — controlled by `travelling` in `user/config/site.yaml`:
+
+| `travelling` | Homepage shows |
+|---|---|
+| `true` | Active trip map + chronological feed (newest first) |
+| `false` | Map with highlight markers + curated highlights grid (max 6, 1 per trip, random) |
+
+Entries and stories opt into the highlights grid via `featured: true` in their frontmatter. The `active_trip` field stores a full page route (e.g. `/trips/italy-2026-demo`), not a bare slug.
+
+---
+
 ## Security

 - `.env` is gitignored. Never commit it — it contains your server credentials and Gitea token.