Runbook Rot: Three Fingerprints of Stale CI Docs and the Check That Catches Each
A runbook is the only document in your repo that gets read at 3 a.m., under adrenaline, by someone who trusts it. When the code is stale you get a b…
DevOps
⚑ Report a ProblemLatest DevOps news from Tech News
All topics
agents
ai
api
architecture
automation
aws
backend
beginners
cloud
database
devchallenge
devops
docker
javascript
kubernetes
llm
machinelearning
mcp
node
opensource
performance
productivity
programming
python
security
showdev
testing
tutorial
typescript
webdev
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…
Modeling Waterfront Assets with Shapezo: A Typed Content Pipeline for Docks, Piers, and Wharves
Most port documentation fails for a boring reason: it is unstructured prose about structured things. A dock is a graph. It has a deck, a piling fiel…
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…
Specification: Agentic Docs-as-Code Architecture Pipeline
Overview This specification establishes an automated, agent-driven software architecture documentation ecosystem. The framework integrates strict st…
Step 3 — Documentation Generation
Exactly. Step 3 is where we finally produce the human-readable architecture document . The important rule is: Step 3 must not rediscover the archite…
Build a Knowledge Layer for SQL Agents with OKF (Part 2)
You connect an AI agent to your shop's database and ask a simple question: "How many active customers do we have?" The agent looks at the tables: cu…
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,…
Implementing Modern Documentation Search for Developer Portals
When developers or users land on a technical portal, their primary goal is to find precise answers quickly. A poorly implemented search bar leads to…
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…
How i documented a Broken codebase without losing my mind.
If you want to use it straight away | Link here I believe we achieved a point in tech where having a broken codebase that started as an MVP and evol…
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…
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…
A Practical Release Inventory for OpenVPN Deployments
Cover illustration: Separate desktop-client, server-component and operating-system tiles linked to individual evidence cards, illustrating a softwar…
How to Build a Game Wiki That Never Dies: Designing for Evidence in Fast-Changing Docs
Every game wiki faces the same failure: the build guide said a weapon was "best," the patch changed it, and now a reader must choose between last we…
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…
Why Confluence Cloud turns your SVG into a flat image
Short answer. An SVG file is not only a picture: it can carry links, scripts and references to outside resources. Rendering one live inside a page w…
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…
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…
Knowledge Management in CI/CD: How Terrain Automates Document Updates
Terrain — prepares the ground so agents don't have to guess where to stand. 🔗 GitHub: https://github.com/sopaco/terrain The Real Problem in CI/CD Pi…
Launching Docgrity 🚀: Documentation integrity for you, your team, and your agent friends. 🤖
Today I'm launching Docgrity — a tool for finding where your documentation disagrees with itself, before it confuses you or the next AI agent workin…
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…