Update doc string with suggestions from dengemann
Further updates to doc string