add PBG upgrading doc & fix provisional links from main PGB