Skip to main content

Documentation Status Model

Summary

Documentation status reports content readiness independently from implementation status. An implemented feature can have draft documentation, and approved documentation can describe planned or transitional behavior when clearly labeled.

Audience

  • Documentation authors, owners, reviewers, approvers, and automation maintainers

Reference Content

StatusMeaningAllowed use
plannedScope and ownership are identified; content is not authoredBacklog, gap analysis, impact planning
draftContent exists but is incomplete or unreviewedAuthoring and evidence collection
reviewRequired reviewers are actively validating contentControlled review only
approvedRequired reviews passedReady for an authorized publication decision
publishedContent is released to its intended visibility audienceActive reader guidance
archivedContent is retained but no longer active guidanceHistorical and migration reference

Compatibility mapping

The current status field remains required during migration:

  • plannedplanned
  • draftdraft
  • in-reviewreview
  • approvedapproved or published, depending on actual release state
  • archivedarchived
  • Legacy deprecated describes content transition and should be paired with product implementation_status: deprecated or a visible replacement path; it is not a canonical documentation_status value.

Automation may recommend a transition but must never set approved or published without the authorized human workflow.

See Also

Keywords

  • Documentation readiness
  • Publication status
  • Status compatibility

Revision Information

  • Status: Draft
  • Last reviewed: 2026-07-15
  • Review cycle: Quarterly