Proposed modifications to the manual

Here are some suggestions for the manual.