Re: Class::DBI Manpage Swindle??

You are assuming that all of the examples in the docs refer to the same cd table definition. I don't see anything in there that says they do, and I assumed they didn't, for the same reasons you list here. If you find that confusing, I'd suggest sending in a doc patch that changes them to all refer to the same table definition or to explicitly state that they don't.

Comment on Re: Class::DBI Manpage Swindle??

Replies are listed 'Best First'.
Re^2: Class::DBI Manpage Swindle?? by metaperl (Curate) on Mar 01, 2005 at 17:54 UTC
Typically when I write a module, my docs are based directly off the results of the test suite: if I promise it in docs, I deliver it in tests. Does the CDBI test suite use the same schema throughout? Is there some way to import code directly from the test suite into the docs for coherence? And yes, I am in favor of one coherent schema for all the docs. And also in favor of that schema being deploying, perhaps like my DBSchema::Sample. Both Tony and Tim were interested in the project, but it sorta died (probably due to my own lack of initiative).	[reply]

Replies are listed 'Best First'.

Re^2: Class::DBI Manpage Swindle??
by metaperl (Curate) on Mar 01, 2005 at 17:54 UTC

Does the CDBI test suite use the same schema throughout? Is there some way to import code directly from the test suite into the docs for coherence?

And yes, I am in favor of one coherent schema for all the docs. And also in favor of that schema being deploying, perhaps like my DBSchema::Sample. Both Tony and Tim were interested in the project, but it sorta died (probably due to my own lack of initiative).

[reply]