Make docs clearer to explain what the pointers are in each method