[Cuis-dev] Reflecting Cuis return character in TheCuisBook

[Hilaire Fernandes]

Hi Mauro,

If you read the PDF version you will see we use both the 
|←|||and||||||↑||||||as seen in Cuis.

For the HTML version, the one the reader may more likely wants to copy 
and post code from, we use := and ^.

What could be done is to add a paragraph somewhere to warn the user the 
code in the html version can be directly copied and pasted in Cuis' 
browser, and that's why the assignment and return symbol are different.

I think the best place is in a section in the preface. Something named 
'How to read the book'. It will talk about:

- the difference of symbols

- the philosophy of the exercises with solutions in annex

- any other point that will ease the experience of the reader

I will add the section and initial writing, so you can amend it at any time

Thanks for the feedback.

Hilaire


Le 28/12/2020 à 23:36, Mauro Rizzi a écrit :
> Hello Hilaire,
>
> I got the idea of using the ↑ character instead of the ^ character in 
> the example code boxes in the book.
>
> Of course we'd have to explain to people that the ↑ character is 
> Cuises (Cuisi? Cuis's?) interpretation of the ^ character meant to 
> give more clarity to the return statement.
>
> I got this idea thinking how the examples given in the codeboxes 
> differ from the ones shown in the cuis system browser.
>
> Of course the second the user puts in a ^ character they'll discover 
> it in their own (and that has a lot of merit too) but I feel someone 
> who is reading without actually coding or copy pasting stuff might 
> think the example is for a different version of the system or something.
>
> What do you think?

-- 
GNU Dr. Geo
http://drgeo.eu
https://pouet.chapril.org/@hilaire

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.cuis.st/mailman/archives/cuis-dev/attachments/20201229/27c397e5/attachment.htm>