Documentation

This is the last PR before the release of `v1.0.0` (stable version!)
Here could also be added a comment proposing to modify the file before saving it