cleaning up documentation to adhere to the conventions