[DOC] improve migration page
[DOC] improve migration page

* re-order some sections
* put existing text in subsections for clarity
* use table instead of bullet list for API conversion steps
* many small changes

apache/logging-log4j2,apache/logging-log4j2,apache/logging-log4j2