code and documentation updates