documentation overhaul, part 2