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).