* fix: make tests descriptions more explicit * fix: clarify function input * fix: clarify output of function, add example