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…
Последние новости
⚑ Сообщить о проблемеTech news from the best sources
Все темы
AI
Gear
News
Tech
agents
ai
api
architecture
automation
beginners
career
database
devchallenge
devops
discuss
javascript
llm
machinelearning
mcp
opensource
performance
productivity
programming
python
security
showdev
testing
tutorial
typescript
webdev
Measure the Executable Share of a Docs Page Before Letting a Model Draft It
Liquid syntax error: Unknown tag 'endraw'
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…
What a good CLI walkthrough should make visible
A good CLI walkthrough shows everything. The exact command. The inputs it took. The action it performed. The output it returned. The errors it can t…
We deleted our docs framework. The replacement is 400 lines of Next.js + MDX.
TL;DR A small docs site needs 5 packages : next-mdx-remote , remark-gfm , rehype-pretty-code , shiki , gray-matter . One route ( app/docs/[[...slug]…
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…
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…
Terminology drift is the quiet tax on a large content corpus
Translation bugs that crash are easy. You find them, you fix them, they stay fixed. The expensive problem is slower: the same concept, translated th…
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…
공공 웹 참조 자료를 유용하게 유지하기 위한 실용적인 체크리스트
개발 업무에서 저장되는 링크의 종류는 생각보다 다양합니다. 공식 문서, 이슈 스레드, 패키지 안내, API 가이드, 릴리스 노트, 코드 예제, 대시보드, 커뮤니티 게시물까지 문제 해결 과정에서 수많은 주소가 기록됩니다. 페이지가 여전히 열리더라도 이전 버전의 설명이…
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…
I audited marshmallow's docs: 184 missing docstrings, 65 stale. Here's the tool I built to fix that
Most teams have one repo nobody wants to touch. It works, it matters, and the people who understood it have moved on. Half the functions have no doc…
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,…
기술 튜토리얼 게시 전 링크 점검
기술 튜토리얼의 링크 점검과 관리 기술 튜토리얼은 설명이 명확하고 화면 구성이 깔끔해도 링크 품질이 낮으면 전체적인 사용 경험이 크게 달라질 수 있습니다. 설치 과정을 따라가던 독자가 패키지 문서, API 레퍼런스, 설정 안내를 차례로 확인하는 과정에서 오래된 페이…
첫 번째 스프린트 이후에도 프로젝트 참조 링크를 유용하게 유지하는 방법
프로젝트 링크는 결정 기록보다 빠른 속도로 늘어나는 경우가 많다. 첫 번째 스프린트만 지나도 프레임워크 문서, 패키지 안내, API 예제, 디자인 메모, 버그 보고서, 배포 가이드, 과거 내부 논의까지 다양한 주소가 한곳에 쌓인다. 처음에는 각각의 링크에 분명한 필…
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…
The Future of Product Documentation
Your next customer might integrate your product without ever visiting your documentation site. Their coding assistant will read it for them, choose…
The Markdown File Changed Even Though I Only Edited One Word
I once opened a Markdown file, changed one word and saved it. The preview looked exactly as expected. Then I checked the Git diff and found changes…
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…
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…
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…
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…