Improvements on the documentation

* Remove duplicated specs.
* Make the docs to include the type specs defined in .hrl files.
* Change the documentation to reflect all the changes that were lately done to the library.