New Investigation Checklist
Use this checklist when adding a new investigation to the website. It covers every content piece you need to create, from folder setup to final publishing.
Before You Start
You will need:
- The raw article text from the content writer
- A Vimeo video URL for the main investigation
- YouTube/Vimeo URLs for individual location footage
- Header images for the investigation, each chapter, and each location
- GPS coordinates for all locations
- Annotation sources (scientific references, reports, links)
Converting raw articles
Content writers usually deliver articles as plain text with numbered references like (1), (2), etc. Use the Parse Annotations tool on the website to convert this into proper MDC markdown:
- Go to
/tools/parse-annotationson the running dev server - Paste the raw article text into the Input field
- Select New style formatting (MDC) (the default)
- Copy the Output — it converts
(1) Annotated sentenceinto:annotation{:ids="[1]"}[Annotated sentence] - Paste into your chapter files and do manual touch-ups (headings, paragraphs, images)
This handles the annotation syntax conversion automatically. You still need to manually add frontmatter, split the text into chapters, and add images.
Checklist
1. Folder Structure
- [ ] Pick the next folder number (check existing folders in
content/nl/onderzoek/) - [ ] Create the Dutch folder:
content/nl/onderzoek/{N}.{slug}/ - [ ] Create the English mirror:
content/en/onderzoek/{N}.{slug}/ - [ ] Both folders have identical names
- [ ] Create subfolders in both:
hoofdstukken/,locaties/,bronnen/
2. Main Article (index.md)
- [ ] Create
index.mdin both NL and EN folders - [ ]
title— investigation title - [ ]
description— 150–160 characters for SEO - [ ]
animals— array of valid animal keys (e.g.,pig,cow,chicken-meat) - [ ]
video— Vimeo URL for the main investigation video - [ ]
image.src— path to cover image inpublic/images/investigations/<slug>/hero.jpg - [ ]
image.alt— descriptive alt text - [ ]
date— publication date (YYYY-MM-DD) - [ ]
published: false— start as draft - [ ]
modifiedAt— current date - [ ]
robots: index, follow - [ ]
sitemap.priority: 0.8andsitemap.changefreq: monthly - [ ] Body text — introductory paragraph(s)
- [ ]
title,description,image.alt, and body text are translated in the EN version - [ ] Structural fields (
animals,video,image.src,date,published) are identical in both
3. Chapters (hoofdstukken/)
- [ ] At least one chapter file (e.g.,
1.chapter-slug.md) - [ ] Files use numbered prefixes for ordering (
1.,2.,3., ...) - [ ] File names are kebab-case and identical in NL and EN
- [ ] Each chapter has frontmatter:
- [ ]
title - [ ]
description(format: "Investigation Title - Chapter Title") - [ ]
image.src— chapter header image - [ ]
image.alt - [ ]
modifiedAt
- [ ]
- [ ] Body text uses proper Markdown headings (
#,##) - [ ] Annotation references use MDC syntax:
:annotation{:ids="[1]"}[annotated text] - [ ] English versions are translated (title, description, alt text, body)
4. Locations (locaties/)
- [ ] One file per location (e.g.,
city-street-number.md) - [ ] File names are kebab-case and identical in NL and EN
- [ ] Each location has frontmatter:
- [ ]
title— descriptive location title - [ ]
position.latandposition.lng— GPS coordinates (decimal degrees) - [ ]
address.street,address.postalCode,address.city,address.country(nlorbe) - [ ]
video— YouTube or Vimeo URL for this location's footage - [ ]
animals— array of animal keys - [ ]
welfareBrandKey— valid welfare brand key ornull - [ ]
owner— farm owner name - [ ]
organization— organization name ornull - [ ]
stableSystem— stable system type ornull - [ ]
companyName— company name ornull - [ ]
modifiedAt
- [ ]
- [ ] Body text describes what was found at this location
- [ ] English versions are translated (title, body)
- [ ] Structural fields (position, address, video, animals, welfareBrandKey) are identical in both
Finding GPS coordinates
- Open Google Maps
- Right-click on the exact location
- Click the coordinates at the top of the context menu — they're copied as
lat, lng
5. Annotation Sources (bronnen/)
- [ ] One file per source, numbered:
1.md,2.md,3.md, etc. - [ ] Each file contains only the reference text (no frontmatter)
- [ ] Every source number referenced in chapters (
:ids="[N]") has a matching file - [ ] Source files are identical in NL and EN (scientific references stay in the original language)
6. Images
- [ ] Cover image for the investigation — added to
public/images/investigations/<slug>/hero.<ext> - [ ] Header image for each chapter — added to
public/images/investigations/<slug>/<descriptive-name>.<ext> - [ ] Format:
.jpgor.webp - [ ] Cover/header images: 1200–1600px wide, 16:9 or 3:2 aspect ratio
- [ ] All images compressed (use Squoosh or TinyPNG)
- [ ] Every
image.srcpath starts with/images/and the file exists - [ ] Every
image.althas descriptive text (5–15 words, no "Photo of...") - [ ] Images are shared across languages — only add once, translate only the
alttext
7. Content Quality
- [ ] Run
pnpm fix:grammar:nlon the Dutch content - [ ] Run
pnpm improve:readability:nlon the Dutch content - [ ] Run
pnpm translate:ento auto-translate to English - [ ] Run
pnpm fix:grammar:enon the English translation - [ ] Run
pnpm improve:readability:enon the English translation - [ ] Review all changes with
git diff content/
See Automation Scripts for full details on these tools.
8. Final Review
- [ ] Start the dev server (
pnpm dev) and check every page - [ ] Investigation overview image renders correctly
- [ ] Video plays on the investigation page
- [ ] All chapters are listed and navigable
- [ ] Map shows all locations with correct pins
- [ ] Clicking a location shows its detail page
- [ ] Annotation numbers link to the correct sources
- [ ] Switch to English and verify the translated version
- [ ] Check mobile layout (responsive)
9. Publish
- [ ] Set
published: truein both NL and ENindex.md - [ ] Set the correct
datefield - [ ] Commit and push
bash
git add .
git commit -m "content: add investigation {title}"
git pushThe website redeploys automatically after merge.