I fully agree with the crappy documentation. Which to be honest isn't consistent with the rest of the python sphere. Documentation tends to be pretty good generally. It's a shame.