8+ hour, 43+ min ago  (306+ words) Why we built jsdoc-scribe without a single line of AI " and what that constraint taught us about doc drift A few weeks ago "...

1+ day, 7+ hour ago  (616+ words) Nearly every "how to do documentation" post is written by a technical writer " someone whose entire role is documentation, on a team where documentation is a budgeted function. That advice is often good, but it quietly assumes a luxury most…...

1+ day, 14+ hour ago  (1343+ words) Saving does not equal ownership; highlighting does not equal understanding. Those deeply insightful articles that excite you at 2 a. m. , those densely interconnected bidirectional links in Obsidian, and those meticulously organized databases in Notion'all are merely "cyber mummies" lying dormant in note-taking…...

1+ day, 17+ hour ago  (341+ words) Every developer has been there. You finally finish that side project, push it to Git Hub, open the repo and the README. md is just # project-name. You tell yourself you'll fix it tomorrow. Tomorrow becomes next week. The repo quietly…...

3+ day, 13+ hour ago  (86+ words) Keeping documentation updated is difficult, especially when projects continue to grow. To make this easier, I've been building jsdoc-scribe, an open-source CLI that generates JSDoc comments and beautiful HTML documentation automatically. The newest release includes several improvements aimed at making…...

4+ day, 1+ hour ago  (232+ words) If you've ever inherited someone else's code with zero documentation, you know the pain. You spend hours just figuring out what a function does before you can even touch it. I built legacydoc to fix that. legacydoc is a tool…...

4+ day, 14+ hour ago  (309+ words) If you've ever exported from Notion or Obsidian, you know the pain: extra whitespace everywhere, empty links, inconsistent heading styles, and stray HTML that breaks your site or docs build. The good news is the content is usually fine. It…...

5+ day, 16+ hour ago  (253+ words) A DESIGN. md has two parts: YAML front matter with machine-readable design tokens, and a markdown body with human-readable rationale. Tokens give an agent exact values; prose gives it the rules. Pairing them is the format's core insight. The front…...

5+ day, 20+ hour ago  (864+ words) A while back, I came across Andrej Karpathy's llm-wiki concept and felt an instant sense of resonance. I've always enjoyed writing things down, but the problem was that everything ended up scattered across different places, and I never had the…...

1+ week, 2+ hour ago  (320+ words) Every modern engineering team has automated builds, tests, and deployments for their code. But documentation? That's still someone manually exporting a PDF, uploading it to Confluence, and hoping it's the latest version. This post shows you how to treat documentation…...