Updating the documentation

Documenting new features and describing better the previous.