major documentation updates part 1