[Dev] Feedback on repository documents requested

[Chih-Chao Lam]

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.

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?

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)

Hope this helps,
chao


On Oct 12, 2004, at 5:39 PM, Ted Leung wrote:

> Hi all,
>
> I checked in a pair of documents for repository features in 0.4.  I'd  
> appreciate any comments, corrections, or questions regarding their  
> contents.
>
> <http://cvs.osafoundation.org/viewcvs.cgi/*checkout*/chandler/distrib/ 
> docs/repository-intro.html?rev=HEAD&content-type=text/html>
>
> <http://cvs.osafoundation.org/viewcvs.cgi/*checkout*/chandler/distrib/ 
> docs/chandler-query-system.html?rev=HEAD&content-type=text/html>
>
> Thanks,
>
> Ted
>
> _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
>
> Open Source Applications Foundation "Dev" mailing list
> http://lists.osafoundation.org/mailman/listinfo/dev