make the docs slightly more clear