Documentation fixes

fixing typos and improving consistency of formatting