[Dev] Feedback on repository documents requested

[Ted Leung]

On Oct 21, 2004, at 3:26 PM, Chih-Chao Lam wrote:

> Hi Ted,
>
> Thanks for writing the documentation. I found it easy to read and 
> understand.
>
> A couple of suggestions for the Busy Developers' guide to the 
> Repository:
>
> 1) A general overview of how the repository fits in with the rest of 
> Chandler would be helpful. I think it's implicit in the doc that the 
> repository can be used separately and also as part of the Chandler 
> PIM. Would be clearer if this were made explicit. Thus, this doc 
> addresses both people who want to develop parcels on top of the 
> Chandler PIM and also parcels completely independent of the Chandler 
> PIM.

I'll add a little bit on this, but I don't think that it will make 0.4. 
  These docs are checked into the build, and Heikki just issued the RC 
build, so we're probably out of runway...

>
> 2) Links to find out more about advanced topics about the repository 
> would be helpful e.g. links to the query doc, how repository 
> transactions work, etc. Also, a link to the repository working group 
> page to reflect latest status of the repository?

Same as above.

>
> Minor clarification:
> I think Morgen pointed this out too:
> Under the Section "Defining Data", I think case matters in the string 
> definitions, right? So, item3 description should read:
> 	• 	A TestKind item at //parcels/simple/data/item3 (with 
> TestAttribute="XYZZY" - because the initialValue for TestAttribute is 
> "XYZZY")
>
> i.e. string values in upper case not lower case (since the 
> initialValue for TestAttribute was defined in uppercase)

This got fixed in the branch version of the docs -- I just committed 
that version to the trunk.

>
> Hope this helps,
> chao
>

It definitely did.

Ted


----
Ted Leung                 Open Source Applications Foundation (OSAF)
PGP Fingerprint: 1003 7870 251F FA71 A59A  CEE3 BEBA 2B87 F5FC 4B42