Field notes
Notes from documentation and standards work
Short essays on software platform documentation and code standards—drawn from audits, handbook workshops, and contributor dry-runs.
April 1, 2026
Keeping API error text honest across languages
Partners trust an API reference when error descriptions match what the service returns and what support staff say on calls.
February 18, 2026
Measuring first-contribution time without gaming the metric
How long a newcomer takes to land a useful change reveals more about your guides than any pageview chart.
January 7, 2026
Writing a code standards chapter people will cite in review
Review comments stick when the handbook gives examples from your repositories, not abstract rules copied from another company.
November 11, 2025
Where platform docs go silent after the first release
Why the first wave of platform documentation often stalls, and how standards reviews catch the drift before contributors give up.