perhaps we should add this to the guide in our docs..