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

Reply via email to