transition docs added
minor bugfixes