← Journal
Governance Development

Documentation becomes reference material, not a description of it

Adeyemi Tobi·Entry 03·1 min read·reconstructed record·Active
Impact

Gave OSG four real, checkable reference documents where none existed before, including the Decision Framework this and every other Journal entry is now built on.

This entry predates the clarification that OSG and CapitalOS are separate companies under a commercial engagement — see Entry 06. Where this entry describes CapitalOS in terms that could read as an internal OSG product, treat Entry 06 as the current, governing description of the relationship.

What changed

An early version of the Documentation page listed three general standards without containing any reference material a reader could actually use or check.

Alternatives considered

  • Expand the existing standards list with more detail, staying descriptive.
  • Leave the page as-is until more content could be produced later.
  • Replace the page with real, usable reference documents, even if the initial set was small.

What was decided

Replace the placeholder with four real documents: the Customer Zero Methodology, the Decision Framework, the Engineering Standard, and the Documentation Philosophy — each written to be read and used in isolation.

Why

A page describing documentation fails the exact test it claims to pass. A diligence-minded reader checking whether OSG documents its operations as claimed would find nothing to check. Fewer, real documents beat a longer descriptive page.

What evidence informed it

Identified directly during an institutional audit of the site, which flagged descriptive documentation as a specific credibility risk.

What happens next

Reviewed as each new document is added, or when an existing one no longer reflects how OSG operates.

Impact

Gave OSG four real, checkable reference documents where none existed before, including the Decision Framework this and every other Journal entry is now built on.

Institutional Learning

What every entry is ultimately for — not just recording that something happened, but what changed because it did.

What triggered this decision

An institutional audit tested the Documentation page against its own claim to be documentation, and it failed the test.

What changed because of it

Documentation moved from descriptive prose about a future standard to the standard itself, publishable and checkable immediately.

What became true that wasn't before

OSG had, for the first time, reference material a third party could actually hold it to.