updates to transitions and faq