improve doc. added transitions