TYNSTEP-456 adding explanations
small minor fixes