improved documentation and updates to files