added some transition javadoc