[Cuis-dev] The Cuis Book for Cuis 6

[Hilaire Fernandes]

Hi Nicola,


Le 21/01/2022 à 12:20, Nicola Mingotti a écrit :
> i think the Layout booklet can be a good thing.
>
> I don't know how much time i can put into its making unfortunately.
As a community, we can work collaboratively on its editing. But better 
to forge first a table of contents, so it will be easier to work for 
several people.
>
> I have 1 suggestion to give. Don't start with one example
> on page 1 and grow it piece by piece up to page 100.
> Like so, the booklet can be used as a tutorial but looses all 
> effectiveness
> as a reference.

Yes it can be a downside of the one example thread all along the book. 
However, note that for "The Cuis Book" we have distinct chapters between 
the explained features and the Spacewar! example thread. So one can read 
the book with a loose interest on the Spacewar! thread. And we have a 
great index table to find valuable information 
(https://cuis-smalltalk.github.io/TheCuisBook/Indexes.html) I am a big 
fan of index.

May be for the Layout, it will be easier to have many small examples all 
along the chapters.

>
> As an example, I think the best document on GUI i found for its balance
> between a tutorial and a reference is the New Mexico guide to Tk. 

We can share informally idea here about the contents.

Hilaire

-- 
GNU Dr. Geo
http://drgeo.eu
http://blog.drgeo.eu
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.cuis.st/mailman/archives/cuis-dev/attachments/20220122/4bffa841/attachment.htm>