Content Governance Standard

This document defines the Frontmatter Schema and Content Governance standard for the ASDLC repository to standardize how metadata is tracked programmatically.

Frontmatter Schema

All content files must adhere to the following schema.

Required Fields

• title (String): The title of the content.
• description (String): A brief description of the content (max 200 chars).
• lastUpdated (Date): The date the content was last updated.
• status (Enum): One of Draft, Proposed, Live, Deprecated, Experimental.

Optional Fields

• tags (List of Strings): Tags for categorization.
• maturity (Enum): One of Proposed, Standard, Deprecated, Experimental.
• supersededBy (String): The slug of the content that supersedes this one.
• relatedIds (List of Strings): A list of slugs for related content.

Deprecation Rule

If a piece of content is deprecated, the following rules apply:

• If status is set to Deprecated, then supersededBy is REQUIRED.
• The content body should be retained for historical context but must be marked with a warning callout.

Experimental Rule

For content marked as experimental:

• Must include a "Stability Warning" callout at the top of the body.