Improved the documentation

The documentation of the function have been improved.
The README.md is now filled with usefull informations.