documentation: migration reference

This adds some quick information about migrating a `suite.rc` file to
the new syntax.

@hjoliver, please review.