Integrate latest diagnostic message cleanup and improvements (#5111)

These changes were already reviewed in the SDK. The primary changes are
adding highlighting of diagnostic locations to pubspec diagnostics.
There was some minor copy and link cleanup as well.

Author: parlough