BLUF

Every post starts with key decisions first, then implementation detail, so both humans and LLMs can parse quickly.

TL;DR

  • Read BLUF first for the core recommendation.
  • Use TL;DR bullets for fast scanning.
  • Structured metadata and internal links improve discoverability.

Why this structure

This blog uses a BLUF-first format so the most important conclusion appears before details.

How to add new posts

  1. Create a new markdown file in _posts/ named YYYY-MM-DD-title.md.
  2. Add front matter with title, description, bluf, and tldr.
  3. Write semantic headings (##, ###) and link to related internal pages.

Recommended post template

---
title: "Post title"
description: "One-line summary"
bluf: "One-sentence bottom line up front"
tldr:
  - "Point 1"
  - "Point 2"
---

## Context

## Approach

## Results

After the last line

Comments & sharing

Agree, disagree, add context, or send this to someone who would have a take.

Share

LinkedIn X Email

Public thread

Comments are public and attached to this post through GitHub Discussions. Sign in with GitHub to join the thread.

Open public discussions

Newsletter, eventually

Get the next brain dump.

No fixed cadence yet. Leave your email for the first issue when it exists.

One list. No schedule. Unsubscribe whenever.