[Zope-dev] Re: [Zope-PTK] ZPatterns Documentation

[Phillip J. Eby]

At 10:58 PM 7/27/00 +0100, Steve Alexander wrote:
>"Phillip J. Eby" wrote:
>> 
>> Just comment, please, preferably in e-mail via Zope-dev.
>> Thanks.
>
>Generally very clear and helpful. Tomorrow, I'll try it out on someone
>who hasn't been looking at ZPatterns a great deal, and see what she gets
>from it.

Thanks.


>A few suggestions. I feel sad that these seem to come across as
>criticisms. Really, I'm very glad that you've found some time to work on
>more accessible documentation.
>

Hm.  Well, your comments have convinced me that 1) I'm not really qualified
to write good beginner docs, and 2) I shouldn't try to combine a design
document with beginner documentation in any event.  :)

Probably the doc needs to be split into seperately focused documents for
"What are DataSkins (for)?" and "How do they work?".  I was trying to
capture all the things that happen in the interactions between DataSkins
and their primary collaborators in order to have that documentation later.
Unfortunately, a lot of that "how" detail is extraneous to the "how do I"
and "why" questions.

Probably as written, the doc is more useful as an introduction to ZPatterns
innards than it is as an intro to ZPatterns itself.