add cylc migration info
add advanced R1 information
Merge pull request #1126 from benfitzpatrick/doc.migration-reference

documentation: migration reference