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

A cookbook would be nice.

John- Maybe you could do a callout for recipes, and then cull the  
best into it ?

Since someone griped about the docs, I'll pipe up...

The info on the unique_key , unique_keys , add_unique_key is lacking   
in clarity.

        unique_key/s are illustrated only one way with two columns in meta- 
 >setup
                unique_key  => [ 'product_id', 'region' ],
        its unclear if that is one unique key or two
        ie:
                create unique key product_id_uidx on table(product_id);
                create unique key region_uidx on table(region);
                        vs
                create unique key product_id_region_uidx on 
table(product_id,region);

        its also unclear if multiple unique keys or multiple column keys are  
even possible in rose -- the docs suggest one or the other, not both,  
and its cryptic as to which is which

the use_key functionality is a bit confusing too -- "Use the unique  
key named KEY to load the object" ... but unique keys don't have  
names, they have columns.  foreign keys and relationships have user  
defined names.

thats my documentation gripe of the week :)

// Jonathan Vanasco

| - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
- - - - - - - - - - - - - - - - - - -
| SyndiClick.com
| - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
- - - - - - - - - - - - - - - - - - -
|      FindMeOn.com - The cure for Multiple Web Personality Disorder
|      Web Identity Management and 3D Social Networking
| - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
- - - - - - - - - - - - - - - - - - -
|      RoadSound.com - Tools For Bands, Stuff For Fans
|      Collaborative Online Management And Syndication Tools
| - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -  
- - - - - - - - - - - - - - - - - - -



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