[Dev] Objection to the new CPIA example

[Jared Rhine]

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.