Fix return type mentioned in the CHANGELOG
Flip example sides, clarify arrows