Your Documentation Has Two Audiences Now (And One Is an AI)
Technical documentation’s audience has changed. It’s no longer just engineers reading pages — increasingly, humans and AI work together: humans make d…
Latest Web news from Tech News
All topics
AI
agents
ai
api
architecture
automation
aws
beginners
career
claude
database
devchallenge
devops
discuss
javascript
linux
llm
machinelearning
mcp
opensource
performance
productivity
programming
python
react
security
showdev
tutorial
typescript
webdev
AI, Language, and the Guilt We Don’t Need
I am a blog writer who speaks English as a second language. Every day, I think in one language and write in another. That gap is real. Sometimes I kno…
Will AI replace technical writers?
The short answer is no. AI will change technical writing in the long run, but not overnight and not completely. There is no denying the change. Compan…
I'm with STUPID ⤴️
I have an idea. As serious and professional developers of serious and professional things, we have all encountered the standard, boilerplatey document…
AI in docs: Documentation dynamic shift most people seem to ignore
I’ve worked as a senior technical writer for over 6 years. Believe me when I say this: The consumers of documentation have shifted from users/develope…
Why would Go do this in its documentation?
Before diving in, let me be clear: this is not a critique nor a complaint about Go. It’s simply an observation that led me to an interesting question.…
Supercharge AWS Diagrams in VSCode with Mermaid and Custom Icons
Want to turn your architecture docs into visual gold? With the new Mermaid.js architecture diagram syntax and custom icon packs, you can create AWS di…
Best GitHub README Examples (And What Makes Them Work)
Most GitHub READMEs fall into one of two failure modes: the wall of text that explains everything except how to get started, or the three-line stub th…
Making Your APIs Visible Using Capabilities for GitHub 7 GitBook Discovery and Documentation
Your organization has more APIs than anyone thinks. Specs are scattered across GitHub repos. Docs exist in GitBook spaces that were created for a laun…
Generate Terminal Recordings for Your CLI Docs Without Touching asciinema
CLI documentation has a trust problem. Users read your examples, try to reproduce them, and get different output. Screenshots go stale the moment a fl…
I tried Karpathy's LLM Wiki pattern on my AWS consulting work — here's what changed
I tried Karpathy's LLM Wiki principle on my own AWS consulting work a few weeks ago, and I can't go back. If you missed it, Andrej Karpathy published …
I Built a Tool That Turns Any Website Into Full Documentation in Minutes
We all know the drill — you ship a product, users love it, then someone asks: "Where are the docs?" Writing documentation is one of those tasks every …
How I Automated Python Documentation Using AST Parsing and Multi-Provider LLMs
We've all been there. You just spent three intense days crafting a highly optimized, beautifully architected new feature. The code is elegant. The tes…