I'm not sure if it needs more detail, but I'd recommend moving it above the code snippet, and maybe also for a release or two, having it in the intro box, which is where we've traditionally put "important upgrade" notes.