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
29165	Initial data howto could better explain how to use migrations	Michel Samia	Tim Graham	"This bug describes issues of this documentation page: https://docs.djangoproject.com/en/2.0/howto/initial-data/ 

The same issues exist in master branch as of today.

According to many sources (e.g. https://www.caktusgroup.com/blog/2015/11/10/initial-data-django/ ), fixtures are deprecated way for managing initial data. It is not mentioned there. Also it doesn't describe how to use migrations for that purpose. Link to https://docs.djangoproject.com/en/1.11/topics/migrations/#data-migrations would be extremely useful.

"	Cleanup/optimization	closed	Documentation	dev	Normal	fixed	initial data migrations	Ed Morley	Ready for checkin	1	0	0	0	0	0