updated readme with installation, usage, requirements, documentation and...

... tests examples