Schema Versioning

Version Control

• Always keep schemas in version control

• Include schema changes in commits

• Document major schema changes

# post.yaml
version: 1.0
lastUpdated: "2024-01-21"
description: "Blog post schema with basic fields and relationships"
changelog:
    - version: 1.0
      date: "2024-01-21"
      changes:
        - "Initial schema creation"
        - "Added basic fields"
        - "Added user relationship"
model: Post
# ... rest of schema

Migration Strategy

• Increment schema version for significant changes

• Keep track of breaking changes

• Document upgrade paths

• Use git tags for major schema versions