Documentation cleanup

Some quick typo fixes and general cleanup.
@tomByrer I believe what you would want in that case is an "a name", as opposed to an empty "a href"?