From 66d9fa43718461de1d083650a4fee1b16ba80f91 Mon Sep 17 00:00:00 2001 From: Mariusz Felisiak Date: Sat, 3 Jun 2023 11:01:15 +0100 Subject: [PATCH] [4.2.x] Refs #23528 -- Made cosmetic edits to swappable_dependency() docs. Backport of 1136aa5005f0ae70fea12796b7e37d6f027b9263 from main --- docs/topics/migrations.txt | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/topics/migrations.txt b/docs/topics/migrations.txt index b62472266c..3f5ccb5318 100644 --- a/docs/topics/migrations.txt +++ b/docs/topics/migrations.txt @@ -224,14 +224,14 @@ Swappable dependencies .. function:: django.db.migrations.swappable_dependency(value) The ``swappable_dependency()`` function is used in migrations to declare -"swappable" dependencies on migrations in the app of the swapped-in model. -Currently, the first migration of this app and as a consequence the swapped-in +"swappable" dependencies on migrations in the app of the swapped-in model, +currently, on the first migration of this app. As a consequence, the swapped-in model should be created in the initial migration. The argument ``value`` is a string ``"."`` describing an app label and a model name, e.g. ``"myapp.MyModel"``. By using ``swappable_dependency()``, you inform the migration framework that -the migration relies on a migration which sets up up a swappable model, +the migration relies on another migration which sets up a swappable model, allowing for the possibility of substituting the model with a different implementation in the future. This is typically used for referencing models that are subject to customization or replacement, such as the custom user