Yet more changes in the documentation ( by Adam)