Skip to main content

Review and Ownership

Summary​

This standard defines accountable ownership, required review roles, review cycles, and the Documentation Definition of Done.

Audience​

  • Documentation owners
  • Documentation reviewers
  • Product owners

Reference Content​

Documentation ownership​

Every page must name one accountable owner in front matter. The owner maintains accuracy, assigns reviewers, responds to stale-content notices, and coordinates lifecycle changes. Ownership must refer to a durable team or role rather than an individual when possible.

Required reviewers​

At least one subject-matter expert must review factual content. Add reviewers according to risk:

  • A technical owner for technical behavior, code, integrations, operations, or architecture.
  • A business owner for terminology, business processes, and user outcomes.
  • A security reviewer for security-sensitive, confidential, access-control, or data-handling content.
  • A documentation reviewer for structure, style, metadata, links, and accessibility.
  • A legal, privacy, or compliance reviewer when organizational policy requires one.

The author must not be the sole approver for customer-facing material.

Review cycles​

Set review_cycle from the approved values. Use a shorter cycle for frequently changing or high-risk content. Review content immediately after a material source change, regardless of its scheduled cycle.

Documentation Definition of Done​

A page is complete only when:

  • Facts verified against source material
  • No unsupported assumptions
  • Correct audience and visibility
  • Required front matter present
  • Terminology consistent
  • Links validated
  • Mermaid diagrams validated
  • Code samples validated
  • Screenshots current
  • Accessibility checked
  • Security review completed when applicable
  • Technical or business owner approval completed
  • Last reviewed date updated

Approval evidence must be retained in the authorized review system.

See Also​

Keywords​

  • Documentation ownership
  • Required reviewers
  • Definition of Done

Revision Information​

  • Last reviewed: 2026-07-14
  • Owner: documentation-team
  • Status: Approved