migrations: add troubleshooting warning

DifferentialOrange · DifferentialOrange · commit bd9e7b66c6c5 · 2024-11-08T15:53:17.000+03:00
diff --git a/doc/platform/ddl_dml/migrations/troubleshoot_migrations_tt.rst b/doc/platform/ddl_dml/migrations/troubleshoot_migrations_tt.rst
@@ -47,6 +47,13 @@ from etcd using ``tt migrations remove``:
 Incorrect migration applied
 ---------------------------
 
+.. warning::
+
+    Any schema change that was made by incorrect migration before the fail or
+    cancellation must be resolved manually on each replicaset before reapply.
+    Apply flags like ``--force-reapply`` affect only internal migration status and
+    unable to revert migration scenario itself.
+
 If the migration is already applied, publish the fixed version and apply it with
 the ``--force-reapply`` option:
 
