updated doc strings to confirm with pep257