adds behavior/settings documentation to transition