Settle between imperative and descriptive styles for docs

As @guidog noticed, we tend to switcher between imperative and descriptive styles when describing the actions performed by a function in documentation. We should settle on one and fix it everywhere.