Document Status

Official status of the document, status levels, and normative keywords.

This document defines the expected shape, behavior, and governance of OLS v1.0. It is written as a standard specification, not merely a UI demo.

Status Values

StatusMeaning
draftWork in progress. Not stable. May change without migration support.
reviewSubmitted for technical and ecclesial review.
candidateFeature-complete pending final validation.
stableApproved v1.0 format. Breaking changes require a major version.
deprecatedStill readable but should not be used for new content.

Normative Keywords

KeywordMeaning
MUSTRequired for OLS v1.0 compliance.
MUST NOTForbidden in compliant files.
SHOULDStrongly recommended unless there is a documented reason.
MAYOptional feature.
RECOMMENDEDBest practice for interoperability and long-term preservation.

Status Is Not Approval

Document status describes the maturity of the technical format. Ecclesial approval describes permitted liturgical use. A stable schema can contain draft or educational-only content, and technically valid content can still require clergy or jurisdictional review.

{
  "ols_version": "1.0.0",
  "type": "corpus",
  "status": "stable",
  "authority": {
    "status": "educational-only",
    "allowedUse": ["education", "private-study"]
  }
}

Schemas and supported values

Document status

status Definition ↗

Technical maturity of an OLS document. Values outside this closed list are invalid.

draftreviewcandidatestabledeprecated