PIM-2902: fixing specs, addressing comments, typos and changelog