#28983: Documentation on providing initial data with migrations is unhelpful
-----------------------------------------+------------------------
Reporter: Rob Atkinson | Owner: nobody
Type: Uncategorized | Status: new
Component: Documentation | Version: 2.0
Severity: Normal | Keywords:
Triage Stage: Unreviewed | Has patch: 0
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 1
UI/UX: 0 |
-----------------------------------------+------------------------
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.
--
Ticket URL: <https://code.djangoproject.com/ticket/28983>
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 django-updates+unsubscr...@googlegroups.com.
To post to this group, send email to django-updates@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/058.86242a82065997b6125a726e784881ec%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
