updated doc to include new transitions