fixes and documentation updates