Wip mds sessions

Thanks for adding docs!

Doesn't Sphinx want to see ```:returns:``` and not ```:return:``` ?