docs: caveats section notes race conditions

* also move details re CRAN policies out of description and into a new
  caveats section lower down.
Merge pull request #15 from jefferis/feature/package-docs-caveats

docs: caveats section notes race conditions