updates and documentation