[BUG #6968] fixed some @ignore's in test classes
[BUG #6968] add section about Compiler Hints to Migration Guide

- to "Special Issues" section, for migration hints that are release-specific
- but are too long for the Release Notes
- here they complement the non version-specific migration advice ("run the
  migration job")
- also add more structure/headings to the entire document