clarify some of the python documentation