Document Priming References and hydration

Updated to explain potential pitfall with disabling hydration while enabling primed references.

Fixes #800
Merge pull request #814