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.