Reword and expand docstring

It was called out as overly cryptic in Maciek Sakrejda's review.