I just pushed a new commit to reword this part of the documentation. Does it look better?