On 5/18/07, Marvin Humphrey <[EMAIL PROTECTED]> wrote: > I suggest that the "conventions" material be cleared from its current > position. Moving it to a footnote, to a separate document a la > references to the "Rose Development Policy", or perhaps even omitting > it entirely would allow the substance of the tutorial to rise to the > top, improving clarity, brevity and immediacy. > > Consider, for example, how much is really gained by admonishing users > to 'use strict' and alerting them to the fact that such declarations > will be missing from the example code. [...] In my opinion, the entire > "Introduction" section of RDBO::Tut can be stricken.
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. -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
