[WIP] more changes to mbar.py docs

I've made more changes to the docstrings, this is still a work in progress.