Document settings.MIGRATION_MODULES

[Baptiste Mispelon]

There's no mention of this new setting in the documentation.

From what I understand, it's a way to override where Django can find migrations for a given app.

It's a dictionary where keys are the names of applications and the values are the name of the module (inside the app) where the migrations reside.

[vedran]

Should this reside in ​https://docs.djangoproject.com/en/dev/topics/migrations/#adding-migrations-to-apps ?

[Baptiste Mispelon]

At the very least, it should be present in the full list of settings [1].

A mention in the migrations documentation itself would be a good idea too though I'm not sure which section is the most appropriate for that.

The second section ("Two commands") says that "the migration files for each app live in a “migrations” directory inside of that app [...]" so maybe a quick mention of the setting at this point would be best.

What do you think?

[1] ​https://docs.djangoproject.com/en/dev/ref/settings/

[gregchapple]

Added a patch in this pull request ​https://github.com/django/django/pull/2352

[Baptiste Mispelon <bmispelon@…>]

In ede99f0ec3a14e3ba218b53c51d4295dbef77e3e:

Fixed #22032 -- added documentation for settings.MIGRATION_MODULES