Some clarifications in the docs