I fell into this trap too. Could we review the (otherwise excellent) docs to make sure they're clear on this matter?