Learning to Fit the Room: A Skill I Built to Practice Concision
How working on my own communication led me to build Concision, a portable skill for AI agents. I’ve received the same kind of feedback more than onc…
Team Management
⚑ Report a ProblemLatest Team Management news from Tech News
All topics
Culture
agents
ai
api
architecture
automation
beginners
career
devchallenge
devops
discuss
javascript
learning
llm
machinelearning
mcp
opensource
productivity
programming
python
react
saas
security
showdev
softwareengineering
startup
testing
tutorial
typescript
webdev
The Globe: Following Your Reasoning Into Other People's Repositories
Keep the Why records why a codebase is the way it is. Decisions can cite decisions in other repositories. The Globe follows those citations outward,…
Split Config Docs Into Extracted Keys and Operator-Signed Constraints
Config documentation fails most often when a generated catalog silently absorbs production promises that nobody reviewed. Parser extraction can list…
Self-Improving Docs, Part 1: Automatically Turning Documentation Gaps Into Pull Requests
This blog is Part 1 of my series, Self-Improving Docs : Turning Gaps Into Pull Requests, on how I run documentation as a self-updating system. In Pa…
Architecture: Write It Down Before Rewriting
Part of the "How to bring order to a project" series — the architecture track. Same context: a growing gamedev project, about twenty services on dif…
How Mautic pairs Promptless with human review to catch up on docs
Originally written for Mautic . A developer just merged a big feature into an app repo, and 'update the docs' lands somewhere on their to-do list. W…
We Built a DevRel Knowledge Base
Developer Relations & Advocacy is often described as the work of helping developers understand and use a product. That description is correct, b…
Wabe Labs Is Born, and Building With Blueprints
Entering the third week of my startup adventure has been a deeply rewarding time of solidifying foundations. Things come together to form an officia…
Architecture Docs Always Outdated? Let Code "Grow" Them Automatically
Terrain — prepares the ground so agents don't have to guess where to stand. 🔗 GitHub: https://github.com/sopaco/terrain The Tech Lead's Pain: Docume…
Test-First AI Documentation: A Workflow That Keeps Generated Docs Honest
AI code assistants have made documentation fast to produce and easy to ignore. The issue is not speed; it's trust. Models can write a polished docst…
Five Files, No Record of Which Came First
Five Files, No Record of Which Came First You started a project on Monday. By Thursday you have five files: a research document, a spreadsheet of da…
Embed Charts in Markdown Without Chart.js: SVG, Data URIs, and What Actually Works
Markdown is great until you want a real chart in a README or docs site. Most people reach for a screenshot, a hosted PNG, or a heavy client library.…
The COBOL Problem
Originally published on adammonago.com . The COBOL Problem names a knowledge pattern. The language is a metaphor. The store still runs. The interpre…
Your Migration Guide Is Already Wrong
James Coombs is a design engineer who replaced a migration guide with 49 JSON data files and a handoff playbook. Engineers on four other teams migra…
Deprecation Doesn't Reach the Copies
Originally published on hexisteme notes . I keep my operating judgment in small, versioned files — one file per decision, each with a status, a list…
Internal vs. External Documentation: What Belongs Where
Originally published at https://ninadpathak.com/articles/internal-vs-external-documentation/ . Internal documentation helps your team operate the sy…
What Is Technical Documentation, and What Should It Include?
Originally published at https://ninadpathak.com/articles/what-is-technical-documentation-and-what-should-it-include/ . Technical documentation is th…
Technical Documentation Template: Build Product Docs With a Tested Structure
Originally published at https://ninadpathak.com/articles/technical-documentation-template/ . Creating documentation often forces several decisions a…
How I Turned a Technical Writing Team Upside Down...Or, Downside Up?
Every time I think about what happened to me that one beautiful day, I still get goosebumps because that was my whole career shift. I’m sure a lot o…
Code First, Specs After: A Practical Guide to AI-Driven Development
1. Introduction In an era where AI agents like Claude Code and GitHub Copilot have become commonplace, the development landscape has undergone a dra…
Good Documentation Explains the Decision, Not Just the Code
A pattern I’ve seen many times in software projects is that documentation starts too late and documents the wrong thing. A team ships a feature, the…
Swagger docs from your existing TypeScript types — no framework required
The problem Recently I was looking for an npm package to generate OpenAPI (Swagger) documentation for my existing TypeScript project. My biggest req…
I Reviewed 10 AI Startup Documentation Sites. Here Are the 7 Mistakes I Kept Seeing.
Documentation is often the first product a developer experiences. Before they see your architecture, your engineering culture, or your code quality,…
Why Developers Don't Read READMEs
Developers are the world's most efficient skimmers. When someone lands on your repo, they're running a rapid mental triage: What does this do? (5 se…
GitHub for writers: Navigating pull request reviews
In the previous post on GitHub for writers: Branches and Pull Requests , you learned how to create branches, commit changes safely, and open pull re…
vike-vue-content: A Zero-Boilerplate Docs Framework Built on Vike + Vue
If you've ever built a documentation site with Vue, you know the drill: Write a +Page.vue for every route Manually wire up Markdown loaders Set up c…
🚀 Released a New Version of jsdoc-scribe
Keeping documentation updated is difficult, especially when projects continue to grow. To make this easier, I've been building jsdoc-scribe, an open…
Humanizing Artificial Intelligence in DevOps Documentation: Making Runbooks Easier to Create and Use
The Runbook That Lied to Me at 3am The pager went off at 3:14am for a wedged OpenStack Neutron agent. I did what any tired engineer does: I opened t…
AI Documentation Tools in 2026: Mintlify vs Document360 vs GitBook — Which Turns Your Code Into Live Docs?
AI Documentation Tools in 2026: Mintlify vs Document360 vs GitBook — Which Turns Your Code Into Live Docs? If you've ever inherited a codebase with…
Your README lies. So I built a bot that opens a docs PR every time you merge.
The README lies. Not on purpose. It was true the day someone wrote it. Then the function got renamed, the flag got removed, the env var changed, the…