The Runbook
← All posts
Blog

How publishing works on this site

A sample post showing the blog template. Replace or delete it when the first real post is ready.

This is a sample blog post — it exists so you can see the blog template and delete it when the first real post is ready.

Adding content

Every piece of content on this site is a markdown file:

  • Newsletter issues live in src/content/newsletter/. Frontmatter carries the issue number, date, status, and cover image. An issue with status: drafting shows up in the "In production" queue.
  • Blog posts live in src/content/blog/. They use this template — byline, date, narrower reading measure, no issue number.

Adding a new category

To add a third category — say, case studies — add a collection in src/content.config.ts, a layout in src/layouts/, and a pair of pages under src/pages/case-studies/. Each category gets its own URL space, template, and RSS feed.

Write the body in plain markdown: paragraphs, ## headings, lists, quotes, links, and code all render in the site's design system.

Get every issue by email.