rework scenario class
minor changes
add documentation
rework class, add documentation
refactor code