further documentation updates