fix documentation typos and improve readability