#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 | Resolution:
Keywords: | Triage Stage: Unreviewed
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------+--------------------------------------
Description changed by Keryn Knight:
Old description:
> 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.
New description:
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" or "zero",
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#comment:1>
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 django-updates+unsubscr...@googlegroups.com.
To post to this group, send email to django-updates@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/067.4c25085c45061b3110804b9ca4820d9b%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
