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
34054	Create a topic about fixtures	Filip Łajszczak	Filip Łajszczak	"From working on #26975 and from reading discussion on the [[https://github.com/django/django/pull/6996#issuecomment-238020222|first PR]] it looks like the current documentation of fixtures requires some work.

Currently information about fixtures is dispersed between different parts of the docs:

* general definition of fixtures lives under reference for `loaddata` [[https://docs.djangoproject.com/en/dev/ref/django-admin/#what-s-a-fixture|command]]
* example of the hand written fixture is in the [[https://docs.djangoproject.com/en/dev/howto/initial-data/|Initial data how-to guide]]
* other bits one can find in [[https://docs.djangoproject.com/en/dev/topics/testing/tools/#fixture-loading|testing tools]] 

There are places where fixtures are mentioned without any prior explanation and without any link to more information, like in `dumpdata` [[https://docs.djangoproject.com/en/dev/ref/django-admin/#fixtures-compression|command docs]]

There are places where fixtures should be mentioned by name but are not, like [[https://docs.djangoproject.com/en/dev/topics/serialization/|seriaIization Topic]] 

Looks like creation of the separate Topic under [[https://docs.djangoproject.com/en/dev/topics/db/|Models and databases]] could be the solution.

Here is the [[https://github.com/django/django/pull/16112|draft PR]] for the discussion. That should also wait for the previous [[https://github.com/django/django/pull/16104|simler PR]] to be resolved and than modified accordingly."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed		Daniele Procida	Ready for checkin	1	0	0	0	0	0