updating doc strings to redefine add