small updates and documentation