reformatted/clarified docs