Re: [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

_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _

Open Source Applications Foundation "Dev" mailing list
http://lists.osafoundation.org/mailman/listinfo/dev