I would rewrite this as a list of parameters and keyword args with what type they parameter should be and what its definition is. Then put the examples below it.