Measure the Executable Share of a Docs Page Before Letting a Model Draft It
Liquid syntax error: Unknown tag 'endraw'
Testing & QA
⚑ Сообщить о проблемеПоследние новости Testing & QA от Tech News
Все темы
agents
ai
api
architecture
automation
backend
beginners
career
claude
cybersecurity
devchallenge
devops
discuss
javascript
llm
machinelearning
mcp
node
opensource
performance
productivity
programming
python
security
showdev
softwareengineering
testing
tutorial
typescript
webdev
How to Capture Tribal Knowledge Before You Need It: A Register, a Backup Person, and a 20-Minute Interview
This article is AI-generated. Every team has things that only one or two people know. How to restart the label printer when it jams. Which customer…
I replayed 7 repos' READMEs in fresh clones. 2 of them fail their own quickstart.
Your README is a promise nobody tests. Setup instructions rot silently. You rename a script, add an env var, switch a package manager, and the quick…
Freeze Tutorial Samples Before a Model Drafts the Walkthrough
Models may draft tutorial narration, but they must not invent the samples that the narration claims to demonstrate. A human-owned fixture ledger sho…
Server, crates and docs
As I've had a pretty busy period, I haven't had the chance to post anything new here, and I only managed to get a few things done on the actual codi…
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…
Best Data Warehouse Schema Documentation Tools (2026): SQLDBM, dbt, DataHub, Atlan & SchemaSpy Compared
Schema documentation used to be the thing teams promised to do "next sprint" and then never did. In 2026, that excuse doesn't hold up. Warehouses ar…
Stop Making AI Agents Grind Through Huge Codebases — I Built a Deterministic Wiki Build System for Them
Joining an unfamiliar codebase, what you want isn't more code — it's a wiki that explains how the thing actually works: which modules exist, where t…
Turn Parser-Visible Flags Into a Config Reference Grid; Sign Defaults and Secret Classes
Configuration reference pages fail when generated prose is treated as the source of production defaults, secret classes, or deprecation windows. A p…
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…
Your README's code examples are untested — here's how I test mine in any language
Your README is full of code — shell commands, config snippets, >>> sessions, example output. And unlike the rest of your codebase, none of…
All 23 of my line-number citations were wrong, and the coverage check could not notice
A table in my spec cited a source file by line number, 23 rows of it. Every one was off by one or two. The coverage check next to it had been green…
Designing Spoiler Controls and Evidence Labels for a Horror Game Wiki
A reader searches for help opening a puzzle box. The result supplies the answer in its preview, includes a later character reveal in the heading, an…
Allowlist Every Path a Docs Generator May Write
Generated reference docs stay trustworthy when a generator may write only restatable files under an allowlisted path. Support windows, uptime figure…
A Staging-Gate Playbook for AI Spikes on Shared Free Hosts
You join the afternoon standup and someone demos a chatbot that already talks to staging data. Token cost looked like zero, so the spike used a free…
Git - Commit Message Format
Introduction The commit message is something we write very frequently during the development process. It summarizes the changes made after completin…
Source-Bound Docs: Models Restate Files, Humans Own Promises
Model-drafted documentation is useful only when every generated claim maps to a file the repository already owns. Sentences without a source become…
Keep Model Drafts Off GA Support Pages
Generated documentation stays safe only when draft authority follows the product lifecycle, not the writer's convenience. Models may draft experimen…
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…
Four spec standards, one baseline, two different decisions
Two side projects, one developer, an AI assistant on both. You work on them when you can and when you feel like it, for fun. And precisely because i…
Doc Drift Is a Bug: A Claim-Checking Loop for Model-Generated Docs
Generated docs fail most often at the boundary between prose and code, where a flag name or a signature silently disagrees with the source. A free-t…
The Docs Draft Pipeline: What an AI May Write and What You Must Own
The most common documentation failure is not a weak prompt or a lazy writer; it is the absence of a clear boundary between machine-draftable content…
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…
Release notes are not release documentation: a reader-task coverage method
A release note can be completely accurate and still leave an integrator unable to use the release. “Webhook retries now use exponential backoff and…
grow-hack: An AI Pipeline That Turns Any GitHub Repo Into Professional Docs in Under a Minute
Every developer has been there: you clone a promising repository, and the README is either missing, three years stale, or says "docs coming soon." E…
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…
Writing evidence-linked docs exposed two missing regression tests
This is a crosspost of the canonical version on GitHub . 1. Problem I run agent-cost , a small open-source CLI that reads local Claude Code / Codex…
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 Best Practices, Tested on Real Developer Docs
Originally published at https://ninadpathak.com/articles/technical-documentation-best-practices-tested-real-developer-docs/ . A documentation page c…