Attempting to improve the documentation a bit

typos, info, formatting