1.9 migration guide

@jfarcand Please review