PIM-2528 : update doc