Code

Opened 7 years ago

Closed 7 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: UI/UX:

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@… 7 years ago.
Patch to docs/django-admin.txt

Download all attachments as: .zip

Change History (4)

Changed 7 years ago by adurdin@…

Patch to docs/django-admin.txt

comment:1 Changed 7 years ago by adurdin@…

  • Summary changed from move documention snippet from models-api to django-admin to [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 Changed 7 years ago by Simon G. <dev@…>

  • Keywords sqlinitialdata documentation added
  • Triage Stage changed from Unreviewed to Ready for checkin

comment:3 Changed 7 years ago by adrian

  • Resolution set to fixed
  • Status changed from new to closed

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

Add Comment

Modify Ticket

Change Properties
<Author field>
Action
as closed
as The resolution will be set. Next status will be 'closed'
The resolution will be deleted. Next status will be 'new'
Author


E-mail address and user name can be saved in the Preferences.

 
Note: See TracTickets for help on using tickets.