added tests + docs for most popular method