making the docs clearer