[Cuis-dev] Reflecting Cuis return character in TheCuisBook

[Mauro Rizzi]

Hi Hilaire,

After giving it more thought I realized the idea of using the ^ was to
allow easy copy pasting of code, sorry.

I do agree the clarification of both the _ and the ^ should be made.

Cheers!
*Mauro Rizzi*

El mar, 29 dic 2020 a las 8:07, Hilaire Fernandes via Cuis-dev (<
cuis-dev at lists.cuis.st>) escribió:

> 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. Geohttp://drgeo.euhttps://pouet.chapril.org/@hilaire
>
> --
> Cuis-dev mailing list
> Cuis-dev at lists.cuis.st
> https://lists.cuis.st/mailman/listinfo/cuis-dev
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.cuis.st/mailman/archives/cuis-dev/attachments/20201229/7ba8a684/attachment.htm>