added new tests, docs and readme examples