News
How to Write an Architecture Decision Record Engineers Actually Read
2+ hour, 39+ min ago (189+ words) "An ADR that nobody reads is worse than no ADR. It creates false confidence that decisions are documented while the actual institutional knowledge lives only in the heads of engineers who were in the room. The test of an ADR…...
Astro Content Collections for Multi-Tenant Help Docs: Rendering Tenant-Specific Documentation Without CMS Sprawl
1+ day, 11+ hour ago (455+ words) I've watched teams burn money on Contentful, Strapi, and Sanity licenses just to manage help documentation that differs slightly between billing tiers. A startup pays $500/month for a headless CMS when they could ship the same thing as static files…...
Documentation is code: LLMs don't actually read it " and honestly, neither do we
4+ day, 8+ hour ago (599+ words) I learned this the hard way: when an LLM says "it matches the docs, it can still be wrong for a boring reason'it didn't read the part that matters. I'm building a small Saa S (checklists as a service). No…...
#3 setting env
4+ day, 15+ hour ago (134+ words) gprbuild 26. 0 (LTS) was not compatible with the library. The AI could not even tell me why until I pasted the error message directly. The linker script had a nested INCLUDE structure, and the linker kept getting lost because nobody told…...
I Gave My Knowledge Base a "Heart." The First Thing It Did Was Kick Most of the Members Out.
5+ day, 25+ min ago (487+ words) Today I ran a small experiment inside my own chaos sea. Lately I wanted to make it a little smarter, so I gave a small universe a "heart"a set of rules plus a semantic anchor, letting it decide for…...
Markdown Is Becoming the AI App Interface
6+ day, 5+ hour ago (437+ words) A quiet developer pattern is getting louder: Markdown is becoming the interface layer for AI apps. Microsoft's markitdown project has been trending because it solves a boring problem that keeps showing up in real products: how do you turn PDFs,…...
Try the Tech Radar #2 " Markdown Typst Converter (Typst's Syntax Is Closer to Markdown Than La Te X)
6+ day, 19+ hour ago (21+ words) Thoughtworks Technology Radar Vol 34 put Typst in the Trial ring. It's the modern typesetting. .. Tagged with typst, markdown, javascript, webdev....
Markdown Should be Supported Everywhere Natively
1+ week, 23+ hour ago (22+ words) You've probably seen this tweet by @trq212 floating around on Twitter about letting agents write HTML. .. Tagged with discuss, html, productivity, webdev....
Preserving semantic styles from DOCX/ODT in Go
1+ week, 1+ day ago (938+ words) Most manuscript conversion tools are very good at moving text from one format to another. That sounds like enough until you work with a manuscript where styles are not just decoration. In many Word or Libre Office files, a paragraph…...
I built a docs Q&A engine that returns null instead of hallucinating
1+ week, 1+ day ago (580+ words) Every "docs chatbot" today routes user questions through Open AI. For open-source maintainers, privacy-conscious teams, and air-gapped environments, that's either too expensive or unacceptable. So I built one that doesn't. Knowledge Base API is a small Fast API service that…...