$transition and $transitionProvider documentation closes #31, closes #32