Re: Manual Readability Feedback

2018-07-16 Thread Bernhard Voelker
On 07/12/2018 03:17 AM, Dale R. Worley wrote: > Bernhard Voelker writes: >>> "Only use 'assert' to catch fully-implemented features of your code." >> ^~~~ >> >> This sounds odd to me - as non-native English speaker - as well. >> What about "Avoid

Re: Manual Readability Feedback

2018-07-11 Thread Dale R. Worley
A couple of quite minor items: Bernhard Voelker writes: >> "Only use 'assert' to catch fully-implemented features of your code." > ^~~~ > > This sounds odd to me - as non-native English speaker - as well. > What about "Avoid to use 'assert' to m

Re: Manual Readability Feedback

2018-07-11 Thread Bernhard Voelker
On 06/28/2018 07:12 AM, Christopher Leonard wrote: > I am writing to inform you of my brief feedback regarding the readability of > your manual. This message does not regard a “bug”; this message is an > informal suggestion to improve the experience of the human manual-reader. Thanks for the fee