Clarify some important points in the docs