Merge branch '291-makemigrations' into 'develop'

Resolve "Document that admins should never, never run makemigrations"

Closes #291

See merge request funkwhale/funkwhale!239

changes/changelog.d/291.enhancement

@@ -0,0 +1,13 @@
+Added multiple warnings in the documentation that you should never
+run makemigrations yourself (#291)
+
+
+About the makemigrations warning
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You may sometimes get the following warning while applying migrations::
+
+    "Your models have changes that are not yet reflected in a migration, and so won't be applied."
+
+This is a warning, not an error, and it can be safely ignored.
+Never run the ``makemigrations`` command yourself.

docs/installation/debian.rst

@@ -240,6 +240,14 @@ This will create the required tables and rows.
     You can safely execute this command any time you want, this will only
     run unapplied migrations.
 
+.. warning::
+
+    You may sometimes get the following warning while applying migrations::
+
+        "Your models have changes that are not yet reflected in a migration, and so won't be applied."
+
+    This is a warning, not an error, and it can be safely ignored.
+    Never run the ``makemigrations`` command yourself.
 
 Create an admin account
 -----------------------

docs/installation/docker.rst

@@ -36,6 +36,15 @@ Run the database container and the initial migrations:
     docker-compose up -d postgres
     docker-compose run --rm api python manage.py migrate
 
+.. warning::
+
+    You may sometimes get the following warning while applying migrations::
+
+        "Your models have changes that are not yet reflected in a migration, and so won't be applied."
+
+    This is a warning, not an error, and it can be safely ignored.
+    Never run the ``makemigrations`` command yourself.
+
 Create your admin user:
 
 .. code-block:: bash

docs/upgrading.rst

@@ -37,6 +37,14 @@ easy:
     # Relaunch the containers
     docker-compose up -d
 
+.. warning::
+
+    You may sometimes get the following warning while applying migrations::
+
+        "Your models have changes that are not yet reflected in a migration, and so won't be applied."
+
+    This is a warning, not an error, and it can be safely ignored.
+    Never run the ``makemigrations`` command yourself.
 
 
 Non-docker setup
@@ -95,3 +103,12 @@ match what is described in :doc:`debian`:
 
     # restart the services
     sudo systemctl restart funkwhale.target
+
+.. warning::
+
+    You may sometimes get the following warning while applying migrations::
+
+        "Your models have changes that are not yet reflected in a migration, and so won't be applied."
+
+    This is a warning, not an error, and it can be safely ignored.
+    Never run the ``makemigrations`` command yourself.