[ZDP] >> I'm willing to maintain either ZSnippets orZHow-To. Are there >anythere >any

Rik Hoekstra Rik.Hoekstra@inghist.nl
Wed, 05 Jan 2000 14:50:49 +0100


<snip>

Euhm, yup, I don't think of small examples as they be tutorials. Certainly
small examples (few lines) should accompany the text. These examples just
clarify the text. They aren't solutions to some problems. When read, the
reader can start programming, but he has to combine all the examples if he
really wants to make something.



OK, agreed. 


> What I think tutorials are, are texts which explain how to make something
> from scratch. Also blocks in source-code is documented. This means the text
> is pointed to a certain solution/goal. So, when read and when programmed a
> tutorial gives a product which can be used right away, which can solve some
> problems, etc.


In summary: Tutorial is a set of recipes
Text is an explanation and more generic. 
I think we agree

> 
> That's nice, but this isn't much different from what I proposed. ie.
> 
> ZBook (content, tutorials)
> 
> or
> 
> ZBook (content, links to ztutorials)
> ZTutorial
> 
> In the last one, ZDP has an extra project (the tutorial project). People
> can search in the tutorials without ZBook.
> If people want to read ZBook, they still can go from ZBook to the Tutorials
> part.. (as if tutorials are part of Zbook -which in this case- is! (at
> least the linked tutorials))
> 
> In only split ZBook and ZTutorial a little bit more then you do... which I
> think has more advantages.

As long as the tutorials only comprise the recipes and have no generic content, I agree.

> 
> >Moreover. where do the howto's fit in this picture and the reference
> material?
> 
> I see the how-to's and reference material not directly inserted in ZBook.
> They should live like FAQ in another folder of ZDP. When the need is there
> and a ZBook needs to be expanded, the how-to's can be placed in extra
> chapters of ZBook. Thus rewritten in some style ZBook is going to be.
> 
> >From ZBook, it should be possible to link to certain how-to's etc. to give
> the reader some extra (if he/she wants to read more)

OK. But then the differences between tutorials are just that they will be produced apart from the ZBook context and for the rest they are the same as tutorials? Because some of the tutorials listed now are not much longer than some howto's. This is not to be bothersome, but basically this boils down to the question how we decide what goes in ZBook and what is left out. 

Rik