updating comments and documentation