refactor 2
extended docs
docs and example
made executable