id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
30597	Improve documentation on reseting an app's migrations to zero.	Keryn Knight	David Vaz	"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."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed			Ready for checkin	1	0	0	0	0	0