Added a guide to upgrading
(cherry picked from commit ced47976a82edacd3e885329edaac6f5d6e4927e)
Add UPGRADING to yardopts, README and dist task
UPGRADING: Fix block formatting
UPGRADING: fix link to README
Merge remote-tracking branch 'origin/pr/606' into upgrading