6d ago · 5 min read · TL;DR Mermaid renders to SVG natively — but the default output usually isn't what you want in a README, slide, or doc. This post walks through the official mmdc CLI, the four theming knobs that actual
Join discussion
May 10 · 4 min read · For about two years, I kept a YAML file next to every Express and FastAPI service I shipped. It started small — a few endpoints, a few schemas. Then the service grew, the team grew, and the YAML file became its own full-time job. The problem isn't wr...
Join discussionMay 8 · 11 min read · Table of Contents Introduction What developers want from an automated documentation tool in 2026 Docs should update when code changes GitHub integration should be simple AI should reduce manual
Join discussion
May 9 · 1 min read · Markdown feels predictable until a document includes tables, nested lists, links, images, or code fences. A README can look fine in an editor and still render awkwardly when published. An online Markdown preview helps catch those issues before the co...
Join discussionMay 8 · 14 min read · Two years ago I inherited a project from an engineer who had left the company. The codebase was clean. The test coverage was reasonable. The architecture was defensible. The documentation was a single README that said "TODO: write docs." There were 2...
Join discussionMay 5 · 3 min read · Your API Needs an llms.txt File — Here's How to Write One and Why Agents Will Read It AI agents are being trained to look for llms.txt files. It's the agent-native equivalent of robots.txt — a file at your domain root that tells agents how to discove...
Join discussion
