Re: [Zope] reality check
Hi Rik, Just wanted to let you know you're _completely_ wrong :-). "Changing context in Zope" is exactly what I was looking for and I find myself referencing it frequently. I'll take your points seriously though: after fiddling with Zope for some weeks now I've found some errors in some documentation and I'll contact the authors off-list. I must say I'm quite satisfied with the Zope documentation. It's fragmented, yes, but there's a lot of it. I've got a big pile of printouts on my desk, bigger than anything available for PHP e.g., and it's just a subset of what can be gotten from the Zope site. I for one attribute my difficulties in implementing Zope more to the complexity and huge feature-set of the Zope engine, than to a lack of documentation. Good documentation helps, but it does not make Zope intrinsically easier. :*CU# Rik Hoekstra <hoekstra@fsw.leidenuniv.nl> writes:
Ok, that's it. Two points (ok I'm grumpy tonight)
1) I can't believe docs are really an issue with anyone. <whining mode> Let me take myself as an example (yes this is whining!). I have squeezed out three drafts of a chapter for ZBook called changing context in Zope. They were almost completely made up of examples. I got exactly one (1) response to the first draft from anyone either on the ZDP list or elsewhere (thanks Patrick).
Now, it may well be they are completely worthless or off target, but then please say so, so I can save myself the trouble.
Say anything. I asked for feedback repeatedly. It is not exactly motivating to write documentation if there is no feedback at all. That makes it appear as though there is no need for documentation - or did I get this wrong.
This also what Open Source is about as far as I'm concerned- _co_ operation</whining mode>
-- *** Guido A.J. Stevens *** mailto:gyst@nfg.nl *** *** Net Facilities Group *** tel:+31.43.3618933 *** *** http://www.nfg.nl *** fax:+31.43.3560502 ***
To: Rik Hoekstra <hoekstra@fsw.leidenuniv.nl> Copies to: zope@zope.org Subject: Re: [Zope] reality check Organization: Net Facilities Group *** http://www.nfg.nl From: gyst@nfg.nl (Guido A.J. Stevens) Date sent: 12 Dec 1999 12:35:45 +0100
Hi Rik,
Just wanted to let you know you're _completely_ wrong :-). "Changing context in Zope" is exactly what I was looking for and I find myself referencing it frequently.
Good to hear it.
I'll take your points seriously though: after fiddling with Zope for some weeks now I've found some errors in some documentation and I'll contact the authors off-list.
I'm sure that will encourage everyone to write more documentation (depending on your remarks that is ;-)
I must say I'm quite satisfied with the Zope documentation. It's fragmented, yes, but there's a lot of it. I've got a big pile of printouts on my desk, bigger than anything available for PHP e.g., and it's just a subset of what can be gotten from the Zope site. I for one attribute my difficulties in implementing Zope more to the complexity and huge feature-set of the Zope engine, than to a lack of documentation. Good documentation helps, but it does not make Zope intrinsically easier.
OK, I agree to this point. Getting Zope takes an open mind and some perseverance, which is more than some people are able to manage Rik
participants (2)
-
gyst@nfg.nl -
Rik Hoekstra