PERI-6 update docs with identity params