updated user docs and docs on cloning