improved docs

Slightly improved documentation, just to make it a bit more clear.