Opened 17 years ago

Closed 15 years ago

Last modified 12 years ago

#5096 closed (fixed)

Doc: Model ref mentions sql-based initial data, should use fixtures

Reported by: oggie rob <oz.robharvey@…> Owned by: Jacob
Component: Documentation Version: dev
Severity: Keywords: sprint-pycon08
Cc: ctrochalakis Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

In 0.96 release notes, there is a mention that fixtures should be used for initial data and custom sql for view, procedures, etc. However the model reference docs show an example using custom sql files and don't mention fixtures at all. For consistency the models ref should describe fixtures and distinguish between the use of fixtures & custom sql files.

Attachments (1)

fixtures-documentation.diff (20.7 KB ) - added by Remco Wendt 16 years ago.
First concept of fixtures documentation

Download all attachments as: .zip

Change History (23)

comment:1 by anonymous, 17 years ago

Owner: changed from nobody to anonymous
Status: newassigned

Agree.

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

Needs documentation: set
Triage Stage: UnreviewedAccepted

Please don't do anonymous triage.

comment:3 by Remco Wendt, 16 years ago

Keywords: sprint-pycon08 added
Owner: changed from anonymous to Remco Wendt
Status: assignednew

comment:4 by Remco Wendt, 16 years ago

Status: newassigned

comment:5 by Remco Wendt, 16 years ago

Information about fixtures is dispersed between different parts of the documentation, I'm actually thinking of giving the concept of fixtures its own entry in the references list. Going to talk this over with Adrian.

comment:6 by Remco Wendt, 16 years ago

Adrian agrees with this, working on it now.

comment:7 by Remco Wendt, 16 years ago

Has patch: set

Ok first concept of the fixtures documentation is ready, adding patch.

by Remco Wendt, 16 years ago

Attachment: fixtures-documentation.diff added

First concept of fixtures documentation

comment:8 by ctrochalakis, 16 years ago

Cc: ctrochalakis added

comment:9 by Jacob, 16 years ago

Owner: changed from Remco Wendt to Jacob
Status: assignednew

comment:10 by Jacob, 16 years ago

Triage Stage: AcceptedReady for checkin

Looks nice - I'll proofread and check in.

comment:11 by Marc Fargas, 16 years ago

Needs documentation: unset

comment:12 by Jacob, 16 years ago

milestone: 1.0

comment:13 by Russell Keith-Magee, 16 years ago

Resolution: fixed
Status: newclosed

It looks to me like these changes have been incorporated (or added independently) into the new docs. If there is something missing, please provide an updated diff against the new docs.

comment:14 by Jacob, 16 years ago

Resolution: fixed
Status: closedreopened

Sorry, I'm actually still working on this one.

comment:15 by Jacob, 16 years ago

Status: reopenednew
Triage Stage: Ready for checkinAccepted

comment:16 by Jacob, 16 years ago

Status: newassigned

comment:17 by Jacob, 16 years ago

milestone: 1.0post-1.0

I'm nearly done with this, but I'm not going to have it done for the official 1.0 release. Sorry!

comment:18 by (none), 15 years ago

milestone: post-1.0

Milestone post-1.0 deleted

comment:19 by Russell Keith-Magee, 15 years ago

milestone: 1.1

comment:20 by Malcolm Tredinnick, 15 years ago

Jacob, do you have a partial rewrite of this in a local branch, or should I just take this patch and munge it appropriately? I don't want to duplicate work if you're partially there.

comment:21 by Malcolm Tredinnick, 15 years ago

Resolution: fixed
Status: assignedclosed

The docs/howto/initial-data.txt file appears to contain a fairly clear discussion of the two options here. Closing this, since it looks fairly complete. If somebody wants to do something else, open a new ticket with a clear patch against trunk that we can evaluate, but I think the proposed changes have all been merged in now.

comment:22 by Jacob, 12 years ago

milestone: 1.1

Milestone 1.1 deleted

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