more formatting changes, comments updates based on feedback, updated automatic documentation