fixed some more comments based on feedback + formatting for auto documentation