add session length, improve documentation