[TIP] fixture documentation, feedback?

[Kumar McMillan]

moving slowly on the fixture module: http://code.google.com/p/fixture/
(where is my free time?)

however, I posted a draft on its end-user documentation:
http://farmdev.com/projects/fixture/docs/

for anyone interested in this module, could you kindly provide
feedback on the state of documentation?  Too much?  Too little?  Hard
to navigate?  Examples too complicated?  Thanks in advance.  From the
google page:

_

fixture: python module for loading and referencing test data

fixture provides several utilities for achieving a fixed state when
testing python programs. Specifically, these setup/teardown databases
and/or work with a temporary file system. This is useful for testing
and came about to solve problems like these:

    * Your test needs to load data into a database and you want to
easily reference that data when making assertions.
    * You want data linked by foreign key to load automatically and
delete without integrity error.
    * You want to reference linked rows by variable name, not
hard-coded ID number.
    * In fact, you don't even want to worry about auto-incrementing
sequences and you don't want to repeat column values that don't
change.
    * You want to recreate an environment (say, for a bug) by using
real data generated from a database query (see
fixture.command.generate).
    * You want to work with files in a temporary file system.