#34054: Create a topic about fixtures
-------------------------------------+-------------------------------------
               Reporter:  Filip      |          Owner:  Filip Łajszczak
  Łajszczak                          |
                   Type:             |         Status:  assigned
  Cleanup/optimization               |
              Component:             |        Version:  dev
  Documentation                      |
               Severity:  Normal     |       Keywords:
           Triage Stage:             |      Has patch:  0
  Unreviewed                         |
    Needs documentation:  0          |    Needs tests:  0
Patch needs improvement:  0          |  Easy pickings:  0
                  UI/UX:  0          |
-------------------------------------+-------------------------------------
 **Background:** 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.

-- 
Ticket URL: <https://code.djangoproject.com/ticket/34054>
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 [email protected].
To view this discussion on the web visit 
https://groups.google.com/d/msgid/django-updates/0107018374c2cdcb-aa7a874f-01d7-446d-a59f-785292f6dfca-000000%40eu-central-1.amazonses.com.

Reply via email to