documentations touchups #2