add/update comments and documentation