PIM-2127 : update the changelog and upgrade doc