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
28983	Documentation on providing initial data with migrations is unhelpful	Rob Atkinson	nobody	"https://docs.djangoproject.com/en/2.0/howto/initial-data/ has a single sentence with links to a RunPython method and low level details, but fails to provide any guidance or links to further documentation necessary to implement loading data. 

the suggested requirement is to provide an example of an initial data loading migration,  clear description of the implications of naming, and specific instructions for loading additional sample data for testing.

The testing documentation at https://docs.djangoproject.com/en/2.0/topics/testing/overview/ also fails to provide useful guidance on how to load test data. 

One aspect i was trying to find was whether initial test data for an app would be loaded if i was testing another app that imported and extended the model of that app. This likewise should be covered in the tutorial https://docs.djangoproject.com/en/2.0/intro/reusable-apps/  - this should cover how test cases for an app will be used in such a context.



"	Cleanup/optimization	closed	Documentation	2.0	Normal	worksforme			Unreviewed	0	0	0	0	0	0