DDaisy Faith Auma·4h agoHow We Measured Whether Our Docs Actually WorkedPage views told us people were reading. They didn't tell us whether anyone succeeded. Here's how I ran A/B tests on API documentation using task completion, time to first successful request, and suppo10 min read·tinytechgirl.hashnode.dev
DDawnsentry·4h agoWhy your network drawing is always out of dateIt was right the day it was drawn. Here's how to stop keeping a second copy of your network up to date by hand.4 min read·dawnsentry.hashnode.dev
EEmma Hicks·4h agoA Federal Proposal Is a System: Inputs, Checks and OutputsIf you work with software, you already know how to think about a federal proposal. It is a system. It has inputs (a solicitation and company knowledge), a process (planning, drafting, review), checks5 min read·govconsolutions.hashnode.dev
HHarshit Satyaseel·1d agoTechnical Writers Should Be the Ones Writing AI Skill FilesWhat a skill file is, why our job already trains us to write good ones, and how one can turn a PRD into consistent first drafts8 min read·tech-writing.hashnode.dev22H
SSzymon Wojciechowski·19h agoOne tag, three documents, and the list that should stay in syncWhy a plant tag should be an identifier, not a string copied between files7 min read·simonlab.hashnode.dev
LLoopGIF·1d agoTurn a Long Demo Recording Into a Short GIF for GitHub Issues and DocsA 20–60 second MP4 is a fine walkthrough and a bad GIF. Trim to the action, cap width and frame rate, and leave the long take as video.6 min read·loopgif.hashnode.dev
VVEILVM·1d agoHow to read MeowShield option docs and tune a preset without guessingA protection UI with a long list of switches is easy to misuse. The usual failure is not that someone left a default in place. It is that they enabled everything that sounded strong, shipped the file,5 min read·veilvm.hashnode.dev
DDocStar·2d ago1. Documentation Analytics: How to Improve Your Docs with DocStarSee which docs pages confuse readers with DocStar analytics and reader feedback, then let your AI agent write fixes as drafts you review and publish.9 min read·docstar-blog.hashnode.dev
AAswani Kumar·3d agoRunnable code examples in MkDocs and Material for MkDocs, in 46 languagesAdd one word to an MkDocs code block and readers can edit and run it in the page, in Python, C++, Go, SQL and 46 languages. Free plugin.5 min read·ashwin31.hashnode.dev
JJack·4d agoKeep a Docs Mascot Consistent: Character Locks and Multi-Image CombinesA documentation site can survive a slightly ugly screenshot. It cannot survive a mascot that changes species between chapters. We learned this the slow way. We had a small illustrated character — a ro6 min read·seedancejack.hashnode.dev