← Documentation
Reference

Documentation Philosophy

What OSG documents, when, and why some things stay internal rather than public.

What gets documented

Any decision that changes architecture, governance, product direction, or operating process gets a record following the Decision Framework, without exception. This applies regardless of how small the decision seems at the time — the cost of a missing record is discovered later, when it's much more expensive to reconstruct than to have written down originally.

What's public versus internal

A decision record is published in the Journal when it doesn't expose sensitive fundraising detail, unresolved security information, or specifics that would give an unfair advantage to someone evaluating OSG adversarially. Everything else is held to the identical documentation standard, but kept internal — available to investors and partners under appropriate access rather than omitted from the standard entirely.

The determining question is never 'would this look good published' — it's 'does publishing this expose something that shouldn't be exposed yet.' A decision that reflects badly on OSG but doesn't meet that bar is still published, because credibility depends on the standard being applied consistently, not selectively.

Versioning

Documentation changes alongside the systems it describes. Every document on this page carries a last-updated date, and a document that no longer reflects current reality is corrected in place rather than left to go stale — consistent with how errors elsewhere on this site (an unverified location, an incorrect incorporation status) have been corrected in place rather than left alongside a later fix.