1. Make it easier for people to comment on your text--- some sort of wiki perhaps?
2. Beginners forget, so telling them that you won't repeat information (key strokes to evaluate an expression) isn't going to help.
3. In the line 'The way in which you evaluate the expression determines where the output goes. Alos notice that the previous examples used integers like 1 and 2 and returned an integer value. This expression uses floating point numbers like 1.0 and returns a float as the result.
' Alos should be Also...
4. If you can get to a feature in the editor with key-strokes list them. If you can get there using the menu say so. If you can get there both ways mention that.
I would like to make it like PHP documentation where you can add comments directly to the HTML pages - but that means mastering the Sphinx Document Building system as well.