Doc fixes

Please let me know if I misunderstood certain information and certain changes are definitely a matter of style.
done in e5da001