Adds some documentation about the user api

Also some minor pep8 fixes