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