some prelim docs for bbauth.py api
some more docs for rest API