[Dev] Objection to the new CPIA example

[John Anderson]

Jared Rhine wrote:

>Heikki Toivonen wrote:
>  
>
>>I would have expected the example to be self contained in the samples
>>directory...
>>    
>>
>
>By co-incidence, I took a few minutes this weekend to see what I would
>need to do to code a toy parcel.  My chandler-svn ebuild for Gentoo
>still worked (mildly surprised), so Chandler built fine.  I knew enough
>to ignore the parcel.xml-based tutorials, and I found John's hello-world
>parcel patch in bugzilla.
>
>I checked the patch over, learned 1 or 2 things, but immediately shyed
>away from applying and proceeding because the code wasn't self-contained
>inside the samples directory and I didn't know whether the ViewableKind
>approach would be appropriate to my situation.  (I would have proceeded
>if docs had helped me decide.)
>  
>
My intention was to make the example self-contained in the samples 
directory -- and also to provide documentation, which is why I described 
this as a "rough draft". The only real changes outside the samples 
directory were to update ContentKind with ViewableKind, since 
ContentKind broke when we switched to initializing the repository with 
python: ViewableKind accomplishes the same thing that ContentKind was 
suppose to accomplish. I also hooked up ViewableKind in the same way we 
had intended to use ContentKind, which never got finished. The only 
other changes were cosmetic, e.g. removing unnecessary imports.

>+1 for a simple example containing the minimum necessary to create a new
>Kind I can modify and see in a new collection.  (I'm thinking I want to
>cut-and-paste example code, have it work, then incrementally modify it
>with my own stuff).
>
>+1 for having a sample which doesn't take pages of code to do right; if
>ViewableKind is the only way to shrink a hello-world parcel to a few
>dozen lines, then I support adding that Kind to 0.6 to match the tenent
>of "comprehensible to new parcel writers".  My first parcel, I'm not
>going to care about stamping.  I'd rather see a different hello-world
>example later which shows me how to make a stampable parcel.
>
>-1 for example code which introduces a "new way" versus showing the
>"existing way".  One patch per idea.
>_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _
>
>Open Source Applications Foundation "Dev" mailing list
>http://lists.osafoundation.org/mailman/listinfo/dev
>  
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.osafoundation.org/pipermail/dev/attachments/20051107/569c0371/attachment.htm