I've tried to clarify the docs a bit.