doc updates per john on how we dedup