documentation overhaul, part 1