updates to documentation and code formatting