-------------------------
Saturday, July 23, 2022, 8:56:57 PM, Jean Abou Samra wrote:

> Thanks a lot Peter and others (privately) for your suggestions.
> Sorry for the very late reply, I've been distracted by other
> things. Your comments are most appreciated.


> Le 13/07/2022 à 18:15, Peter Toye a écrit :
>> This looks great! Just what I'd needed a couple of years back when I > was 
>> still programming.
>> I've only just started with it, but there are a few niggling comments > 
>> about the English version. I've only got to page 2 (getting started) > so 
>> far.
>>   * On my browser (Firefox in Windows) the 'v. latest' is too close to
>>     the bottom of the main frame, and I can't click on the
>>     'previous/next/index' without very careful manipulation of the
>>     slider. Can it be moved up a cm or so?


> This is a bit tricky because I don't know how to test it
> locally without uploading on Readthedocs, and I'm bad at
> CSS ...
... so am I.

>>   * On page 1 (Why Scheme?) it's slightly better English to say 'There
>>     is no single implementation of Scheme'
>>   * On page 2 (Getting started) the comment about testing under
>>     Windows is not translated into English! I suggest 'I am unable to
>>     test these commands under Windows. If they do not work, write to
>>     the list.'
>>   * Again on page 2, the commands don't work! You forgot to add the
>>     'lilypond'.
>>     C:\Program Files (x86)\LilyPond\usr\bin>lilypond
>>     scheme-sandbox works fine on my machine.
>>   * On page 2 'Literals' the comment about decimal numbers isn't
>>     translated. I'm not sure about the best translation of 'nombres
>>     décimaux'. Personally I'd use 'floating-point numbers' on the
>>     grounds that all numbers, including integers, are decimal.

> Done.


>>   * The comment 'and a few others' about the characters allowed in
>>     variable names is rather annoying. How does a user know what to
>>     expect if they use a forbidden character? A list would be really
>>     useful.


> Um. The precise rules for valid identifiers are described
> as a formal grammar on pages 12 and 13 of R6RS
> <http://www.r6rs.org/final/r6rs.pdf>
> (see the <identifier> production). I'll try to put
> a list of a few characters that are valid and which
> are useful to know about, like ? and ! because they
> occur regularly at the end of function names (for
> predicates and side-effecting functions), but I'd
> rather not explain the full rules, as they are quite
> complex ...
Ouch! I see what you mean. And this is meant to be simplified? But the problem 
really is that if a user tries to use an identifier with an illegal syntax, how 
do they know? This is rather like those really annoying websites which ask you 
to choose a password, and then tell you that it's illegal without telling you 
why.
 
> Best,
> Jean
All the best,
 
Peter

Reply via email to