Add upgrade documentation

[bzub]

#164 introduced breaking changes to BGP Peer related CLI/annotations. We should have a dedicated document that explains how to handle these changes during upgrades. It can be used for future breaking changes as well.