dotnet/roslyn
<inheritdoc cref> has bad default for `path` attribute, leading to senseless inherited doc
Offen
#45.994 geöffnet am 15.07.2020
Area-IDEConcept-Continuous ImprovementIDE-IntelliSensehelp wanted
Repository-Metriken
- Stars
- (20.414 Sterne)
- PR-Merge-Metriken
- (Durchschn. Merge 6T 17h) (256 gemergte PRs in 30 T)
Beschreibung
Version Used: 16.8 (30313.166.master)
Steps to Reproduce:
public class C
{
/// <param name="a"><inheritdoc cref="M(int,int)" path="/param[@name='a']"/></param>
public void M(int a)
{
if (a > 0)
{
}
}
/// <summary>summary</summary>
/// <param name="a">A description</param>
/// <param name="b">B description</param>
public void M(int a, int b)
{
if (a > 0 || b > 0)
{
}
}
}
Expected Behavior:
I expect the default path to provide the same meaning as the explicitly specified path, as shown here:
Actual Behavior:
Instead, I see a concatenation of all param docs together, with not so much as a delimiter:
