Opened 17 years ago

Closed 17 years ago

#3302 closed defect (fixed)

[patch] move documention snippet from models-api to django-admin

Reported by: anonymous Owned by: Jacob
Component: Documentation Version:
Severity: normal Keywords: sqlinitialdata documentation
Cc: Triage Stage: Ready for checkin
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

Ticket #2953 (http://code.djangoproject.com/changeset/2953) added an an important clarification on how sqlinitialdata works, under the "providing initial sql data" header:

---
Note that if you have multiple SQL data files, there's no guarantee of the order in which they're executed. The only thing you can assume is that, by the time your custom data files are executed, all the database tables already will have been created.
---

However, there is no mention of this behavior in the django-admin documentation on the sqlinitialdata option itself, which is where I would have expected it to be (and would have saved me some time). Since you reference and link to the django-admin sqlinitialdata section documentation in the previous paragraph on models-api page, this paragraph would be more appropriate in the django-admin sqlinitialdata section.

Attachments (1)

initialsqldoc.diff (499 bytes ) - added by adurdin@… 17 years ago.
Patch to docs/django-admin.txt

Download all attachments as: .zip

Change History (4)

by adurdin@…, 17 years ago

Attachment: initialsqldoc.diff added

Patch to docs/django-admin.txt

comment:1 by adurdin@…, 17 years ago

Summary: move documention snippet from models-api to django-admin[patch] move documention snippet from models-api to django-admin

Added patch that added the note to the django-admin reference. However, I think the existing note should stay where it is, as that's where people will be reading about using initial sql.

comment:2 by Simon G. <dev@…>, 17 years ago

Keywords: sqlinitialdata documentation added
Triage Stage: UnreviewedReady for checkin

comment:3 by Adrian Holovaty, 17 years ago

Resolution: fixed
Status: newclosed

(In [4425]) Fixed #3302 -- Added small note to docs/django-admin.txt about ordering of initial-data SQL files

Note: See TracTickets for help on using tickets.
Back to Top