Engineering owns docs content; Customer Engineering or Marketing owns customer-ready packaging

May 26, 2026 at 3:28 PMoperationalhigh

Situation

In Ryan 1:1, Peter split docs into two layers and assigned ownership cleanly: (1) the technical content, details, and accuracy IS engineering responsibility — same as QA. If Ryans org helps fine, but not held to it. (2) Making docs customer-ready/pretty is NOT engineerings responsibility — that lives with Ryan or Lindsay; they decide between themselves where it lives, Peter does not care which.

Reasoning

Same accountability discipline as QA. The bug Peter has been fixing for months is engineers shipping things as done without QA or docs, then expecting Ryans org to backfill the gap. By splitting docs into content-vs-packaging Peter preserves engineering accountability for accuracy while not making engineers do graphic design or polish. This also clears the channel for Ryan to invest in tooling (similar to the QA gauntlet he built) without becoming a permanent docs backstop.

Additional Context

Extends D4 from the 2026-05-21 reflection (Engineering owns all QA) to the docs domain. The QBR same week (5/22) listed QA + docs as woefully incomplete and named Peter as the owner of a new Definition of Done that codifies both.

Observed Evidence

Direct quote: "I want to hold engineering responsible for producing the content." + QBR action item explicitly assigned to Peter to write the new Definition of Done.

Matching Patterns

35%
Accountability Follow-Through(clear ownership and no escape hatch)

Confidence Breakdown

33/35
Evidence
25/30
Pattern
20/20
Source
15/15
Corroboration

Reasoning Depth Analysis

Org Signal:Definition of Done is changing — accuracy of content cannot be punted
Who Affected:Justins/Nathans teams (now produce docs content), Ryans team (helps but not responsible), Lindsay (packaging path), customers (better docs)
Precedent:Same accountability frame as QA, applied to a new domain
Consequences:If enforced, gradually drives up documentation quality; if not, engineering keeps offloading and Ryans team burns out
Timing:Codify in the new Definition of Done doc Peter owns from the QBR

Source

reflection

AI Confidence

93%

Related Context

🎥
Ryan <> Peter Weekly 1:1 (2026-05-21)

fathom

Docs same thing as I just said about QA — that is the responsibility of engineering. ... Making it pretty and customer ready, not the responsibility of engineering.

🎥
Engineering QBR (2026-05-22)

fathom

Peter Nelson will define a new, consistent Definition of Done that includes QA and documentation.

Outcome

No outcome recorded yet.

Decision ID: 4cc049a4-edf9-4650-9185-6b32188120ac