Description
Feature Name
Pass "link summaries" instead of "resolved information" in external documentation source responses
Description
Continuing the work from #468; the OutOfProcessReferenceResolver/Response includes OutOfProcessReferenceResolver/ResolvedInformation values which lose some information that's available in LinkDestinationSummary (for example the resolved information abstract in plain text and loses any formatting or links that was in the original abstract). We should update OutOfProcessReferenceResolver to support passing LinkDestinationSummary values and phase out OutOfProcessReferenceResolver/ResolvedInformation
Motivation
There are two main motivations for this change:
- Not losing information in the content of external pages
- Avoiding code duplication;
OutOfProcessReferenceResolver/ResolvedInformationneeds to be kept up to date whenever there are changes to theLinkDestinationSummarydata.
Importance
This change will allow formatting and links in external page's abstracts to be preserved.
Alternatives Considered
We could add additional fields to OutOfProcessReferenceResolver/ResolvedInformation for any information that it currently loses compared to LinkDestinationSummary which would give both types the same capabilities but that would make the code duplication and maintenance worse than if we only had one type for this.