adds documentation and testing for new session object