#30597: Improve documentation on reseting an app's migrations to zero
-----------------------------------------+------------------------
               Reporter:  Keryn Knight   |          Owner:  nobody
                   Type:  New feature    |         Status:  new
              Component:  Documentation  |        Version:  master
               Severity:  Normal         |       Keywords:
           Triage Stage:  Unreviewed     |      Has patch:  0
    Needs documentation:  0              |    Needs tests:  0
Patch needs improvement:  0              |  Easy pickings:  0
                  UI/UX:  0              |
-----------------------------------------+------------------------
 This came on IRC a while back, because someone didn't know how to
 effectively undo everything they'd done.

 The entire documentation that I can find is as follows:
 `python manage.py migrate --help` says **Use the name "zero" to unapply
 all migrations**, and so does [https://docs.djangoproject.com/en/2.2/ref
 /django-admin/#migrate this page]. That's it.

 It's not clear what ''unapplying'' migrations means, unless you're
 familiar with it already - it's not described
 [https://docs.djangoproject.com/en/2.2/topics/migrations/ on this page]
 after searching for "unapply" or "undo" or "reset" or "restart", nor is it
 clarified in the help text for the command,  and the process of resetting
 an app's state to start-from-scratch isn't mentioned at all in the
 migrations docs, except for this tiny affordance.

-- 
Ticket URL: <https://code.djangoproject.com/ticket/30597>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To post to this group, send email to [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/052.99495312809cf2e27cba854fdd798f32%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.

Reply via email to