Updated docs with rationale and more caveats.