several documentation updates