# Schema Versioning

### Version Control

* Always keep schemas in version control
* Include schema changes in commits
* Document major schema changes

```yaml
# 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
