[Zope3-dev] Zope 3 Documentation and Quality Assurance

Jim Fulton jim at zope.com
Tue Jan 20 19:30:50 EST 2004


Barry Pederson wrote:
> Stephan Richter wrote:
> 
>> On Tuesday 20 January 2004 13:31, David Harris wrote:
>>
>>> In all seriousness, the mocking nature of the previous analysis is not
>>> directed at any author, but at myself. I apparently need guidance, and I
>>> believe I am not alone in the world of 'potential users'.
>>
>>
>>
>> Dave,
>> did you try the cookbook (starting at part C)? It is much more verbose 
>> and takes you through step by step and almost line by line.
> 
> 
> I have to say I think the cookbook format makes more sense for online 
> documentation.  I always get the feeling with the slide presentations 
> that I'm missing something.
> 
> I'd imagine that if Jim's presenting the slides at a sprint, there's 
> probably some extra commentary that goes with them to fill in between 
> the lines? 

Right. I talk a lot.

 > If so, then those of us that are just looking at the text of
> the slides and nothing else are probably missing out on some key bits.

Right.  They are mainly there for reference by people who've listened
to me speak.  Nevertheless, may people have told me that they've gotten
a lot out of them by themselves. <shrug>

Anyway, I'll stop recomending the tutorial until it os more than slides.

Jim

-- 
Jim Fulton           mailto:jim at zope.com       Python Powered!
CTO                  (540) 361-1714            http://www.python.org
Zope Corporation     http://www.zope.com       http://www.zope.org




More information about the Zope3-dev mailing list