[Cuis-dev] The Cuis Book for Cuis 6

[Nicola Mingotti]

Hi Hilaire,

i think the Layout booklet can be a good thing.

I don't know how much time i can put into its making unfortunately.

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.

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.
https://www.rose-hulman.edu/class/cs/csse120/Resources/Graphics/tkinterReference-NewMexicoTech.pdf
Recently I use PyQt if I need Python and graphics, but I remember I used 
this booklet several times in the past.

I general i think on the long run a book about Morphic in Cuis should be
the final target. With a list of established Morphs, a preview, their 
function
description and a very simple use example. Not for now, since this is 
time of changes
in the Morphs family ;)


bye
Nicola





On 1/21/22 10:06, Hilaire Fernandes via Cuis-dev wrote:
>
> Thanks Ken for the review. That is so important.
>
> I want to propose the community to write a smaller book about the 
> Layout, less than 100 pages.
>
> The Cuis Layout system is mature enough to solidify its documenting in 
> a book.
>
> Carefully written books bring legitimacy to the Cuis project. It is a 
> very valuable asset for the project and the community as it help to 
> improve visibility.
>
> Moreover it brings satisfaction to those writing it: its perimeters 
> both in space and time are quite well known in advance.
>
> Anyone
>
> Hilaire
>
>
> Le 20/01/2022 à 22:47, ken.dickey at whidbey.com a écrit :
>> On 2022-01-20 12:51, Hilaire Fernandes via Cuis-dev wrote:
>>
>>> I put a final push to update "The Cuis Book" to match Cuis 6.
>> ..
>>> Both html and PDF builds are now online.
>>>
>>> Please take a look.
>>
>> Hilaire,
>>
>> Both look good to me.
>>
>> Thank you so much for doing this!
>>
>> -KenD 
> -- 
> 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/20220121/93f5ef09/attachment.htm>