dotnet/roslyn

<inheritdoc cref> has bad default for `path` attribute, leading to senseless inherited doc

开放

#45,994 创建于 2020年7月15日

 (2 条评论) (0 个反应) (0 位负责人)C# (4,257 个派生)batch import
Area-IDEConcept-Continuous ImprovementIDE-IntelliSensehelp wanted

仓库指标

星标
 (20,414 个星标)
PR 合并指标
 (平均合并 6天 17小时) (30 天内合并 256 个 PR)

描述

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:

image

Actual Behavior:

Instead, I see a concatenation of all param docs together, with not so much as a delimiter:

image

贡献者指南