#7: documentation work in progress
#7: documentation about transition handler written.