docs: caveats section notes race conditions

* also move details re CRAN policies out of description and into a new
  caveats section lower down.
* this is probably a desirable addition before/in addition to merging hadley#2