docs: document typical usage of a session object