github-monolith-migrations

What problem does it solve?

The GitHub monolith migrations guide helps teams coordinate and document database migrations across a large codebase, ensuring consistency in schema changes and ownership across Rails apps.

Core Features & Use Cases

• Pre-flight guidance for updating migration-related configuration files (db/migrate, db/tableowners.yaml, lib/github/database_structure.rb, db/schema-domains.yml, and sorbet RBI files) as part of a change-set.
• Clear patterns for generating migrations with Rails, testing migrations, applying RuboCop rules to maintain quality, and ensuring changes are auditable.
• Use case: when introducing a new table or modifying an existing one across multiple clusters with defined ownership and domain constraints.

Quick Start

Start by generating a new migration with Rails and updating the related configuration files to reflect the schema change.