Settle between imperative and descriptive styles for docs
As @guido.gunther 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.