News
I built a tool that turns your code into clean documentation in seconds
11+ hour, 6+ min ago (135+ words) I'm a software engineer and this is my first Saa S. I kept seeing the same problem: writing documentation is boring, and most projects end up with a messy README that says "some app I made, works on my machine" " So…...
Introducing Advanced Markdown Previewer: A Quick Tour
18+ hour, 54+ min ago (243+ words) Documentation workflows fracture when Markdown content needs precise rendering checks. Developers and technical writers waste cycles toggling between source editors and preview tools, breaking concentration and slowing iteration. A single environment that renders complex Markdown in real time eliminates that…...
Evergreen Notes: Write Notes That Compound Over Time
20+ hour, 55+ min ago (1713+ words) Most engineering notes are written once and forgotten. You capture something during a debugging session, paste it into a doc, and rediscover it two years later with no context for why it mattered. The problem is not effort. Engineers write…...
Knowledge Graphs: The Missing Piece in Most RAG Systems
1+ day, 2+ hour ago (361+ words) If you've been exploring AI agents recently, chances are you've come across RAG (Retrieval-Augmented Generation). A typical RAG system looks something like this: This architecture has become the foundation for many AI assistants, chatbots, and knowledge-based agents. It works surprisingly…...
The Self'Documenting Code Quest: How I Stopped Writing Comments and Started Writing *Readable* Code
1+ day, 19+ hour ago (532+ words) It started on a rainy Tuesday. I was pairing with a junior dev who kept asking, "What does this do?" every few lines. I'd point to a comment and say, "See? It says it right there." He nodded, then three…...
Give Your Codebase a Constitution
2+ day ago (952+ words) For most of my career, the real rules of a codebase weren't written down. Senior engineers knew which layers could talk to which. They knew which dependencies were forbidden, which schemas were effectively frozen, and which shortcuts would create problems…...
Documentation Is a Feature
2+ day, 17+ hour ago (412+ words) One of the biggest mindset shifts I've had as a builder is realizing that documentation isn't separate from the product. Documentation is the product. Or at least part of it. As developers, we often treat documentation as something that happens…...
Batch-converting documents to markdown with Microsoft's markitdown
3+ day, 16+ hour ago (145+ words) Here's a quick tool that landed in my queue recently: microsoft/markitdown It's a Python CLI that converts PDFs, Word docs, Power Point, and Excel files to Markdown. Not groundbreaking, but if you've ever had to process a folder of…...
Technical Writing Advice
3+ day, 19+ hour ago (1154+ words) I've occasionally thought about writing about how to write (and how not to write) technical material. Recently, someone e-mailed me asking for advice about doing just that. So this article is a collection of my previous thoughts about this as…...
Your docs have dead links. I built a zero-dependency CLI that catches the local ones " no network
5+ day, 8+ hour ago (142+ words) You rename a file, restructure a folder, tweak a heading " and quietly leave a trail of dead links across your README and docs. Nobody notices until a reader clicks. /old-guide. md and gets a 404. There are tools for this, but…...