On 5/18/07, Marvin Humphrey <[EMAIL PROTECTED]> wrote: > On May 18, 2007, at 9:00 AM, John Siracusa wrote: >> Since those sections are clearly labeled and there are links to all >> the major sections (in the HTML version of the POD, that is), I don't >> think it's too onerous for those people that want to skip them to do >> so. > > Skip the "introduction"? You contradict yourself. From the > introduction: > > But I recommend reading the tutorial from start to finish at > least once.
There's no contradiction. > Do you value brevity? Sure, but since the tutorial is the only piece of non-reference documentation, I tried to spell out as much as I could. Obviously, one document can't satisfy everyone. (I've also had people tell me the tutorial is too terse and needs to be expanded! :) I think there's a place for a quick-start guide, a FAQ, and a cookbook, at least. Right now, unfortunately, there's just the tutorial. -John ------------------------------------------------------------------------- This SF.net email is sponsored by DB2 Express Download DB2 Express C - the FREE version of DB2 express and take control of your XML. No limits. Just data. Click to get it now. http://sourceforge.net/powerbar/db2/ _______________________________________________ Rose-db-object mailing list Rose-db-object@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/rose-db-object