Hopefully more clear, as per #700 @j-po
Another doc tweak