first complete version
documentation improvements in the readme