document updates part 1
documentation rework part 2