[m-rev.] for post-commit review: transition guide fixes

[Julien Fischer]

On Fri, 5 Jul 2019, Zoltan Somogyi wrote:

> For review by Julien.
>

That's fine.  I will update the documentation on the website after
tonight's ROTD build.

Julien.