Add note about higher/lower-level transition APIs