Skip to main content

Documentation Metadata Standards

This document defines the standards for metadata headers (frontmatter) across all WepNG architectural documentation.

📋 Status Lifecycle

StatusDescription
DRAFTInitial creation, contents are subject to major changes and not yet verified.
REVIEWContent is complete and awaits peer or lead architect review.
APPROVEDVerified and official documentation. Baseline for implementation.
OBSOLETEDeprecated content, kept for historical context or traceability.

🔢 Versioning Logic

We use a simplified semantic versioning 1.x.y starting from the 2026 Documentation Reboot.

  • 1.0.0: Initial baseline.
  • Increment y (Patch): Minor fixes, typo corrections, or small clarifications.
  • Increment x (Minor): New sections, significant logic updates, or structural changes.
  • Major 2.0.0+: Reserved for complete architectural paradigm shifts.

🏗️ Context Field

The context field helps in identifying the structural scope of the document.

Examples:

  • Architecture / Strategy
  • Module / BackOffice
  • Module / WepAccess
  • Specification / FeeContext
  • Guideline / Productivity

🛠️ Automation

The management of last_update and header presence is automated via:

  • Skill: docs/architecture/generator/metadata_manager.py
  • Workflow: /organize_docs (includes header validation)