update to provide more details and documentation