Documentation

This is the last PR before the release of `v1.0.0` (stable version!)
To be discussed