PIM-2989 : update changelog and upgrade doc