Missing Documentation on how to combine migrations in Django

[vanessaavviles]

Overview

We need to add a description of how to combine migrations in Django so that developers can integrate changes effectively. For example, if max_migration.txt is at 0027_... and you want to combine 0025_, 0026_, 0027_ into one.

Action Items

• Add content in What's missing? section below to a new numbered item and page here: https://hackforla.github.io/peopledepot/contributing/howto/, editing or revising if necessary

Resources/Instructions/Tags

• 1.01 docs: How to combine migrations before merging a PR #282
• 1.02 django

Documentation Addition Notes

What's missing?

• The process for combining migrations in Django is:

1. Roll back core app migrations to 0024

   ./scripts/migrate.sh core 0024

2. Delete unwanted migration files

   rm app/core/migrations/00{25,26,27}_*

3. Recreate max_migration.txt for core app

   docker-compose exec web python manage.py create_max_migration_files --recreate core
   # the file core/max_migration.txt should contain "0024_..."

4. Create combined migration file for core app

   ./script/migrate.sh core

Where should it go?

When would this information have been useful?

• Many initial passes for PRs have multiple migration files that should really be a single Create Table migration

Which roles will benefit most from this information?

• Back end/ Dev