documentation additions across the board