Field Notes
Field notes on documentation practice
Articles on structuring developer documentation, knowledge bases, and the decisions teams face when written knowledge drifts.
Short essays and practical notes from consulting engagements — written for engineers and documentation leads, not generic productivity advice.
When three getting-started guides compete
How conflicting onboarding paths appear, how to spot them in an inventory, and how to retire two without stranding readers.
Inventory before information architecture
Why sketching a perfect tree before counting pages wastes weeks — and what a lightweight documentation inventory should capture.
Review cadences that survive sprint pressure
Monthly documentation reviews fail when they compete with releases. Here are cadences teams in Taipei have actually kept.
Dual-language documentation without double maintenance hell
English and Traditional Chinese developer docs can coexist — if you decide which language leads each topic and how translation updates flow.