CS1584, CS1658 from `inheritdoc cref` when referencing method with value tuple parameter

When <inheritdoc cref="..."/> refers to a member with a parameter whose type is a ValueTuple intrinsic, the completion list will help select the member while typing the cref attribute’s value, but then C# will emit several warnings around the xml being invalid and the member not being found.

Repro on SharpLab.io

using System;
public class C {
    /// <param name="progress"><inheritdoc cref="M2(IProgress{int})" path="/param[@name='progress']" /></param>
    public void M(IProgress<int> progress) {
    }
    
    /// <param name="progress">Some progress</param>
    private void M2(IProgress<int> progress) {
    }
    
    /// <param name="progress"><inheritdoc cref="N(IProgress{(int,int)})" path="/param[@name='progress']" /></param>
    public void N(IProgress<int> progress) {
    }
    
    /// <param name="progress">Some progress</param>
    private void N2(IProgress<(int,int)> progress) {
    }    
}

Expected

no warnings

Actual

warning CS1584: XML comment has syntactically incorrect cref attribute 'N(IProgress{(int,int)})'
warning CS1658: Identifier expected. See also error CS1001.
warning CS1658: Syntax error, '>' expected. See also error CS1003.
warning CS1658: ) expected. See also error CS1026.

[bfren]

I solved this by removing the argument types in the cref, e.g.

/// <inheritdoc cref="QueryOptions.AddJoin{TFrom, TTo}(QueryParts, (TFrom table, Expression{Func{TFrom, string}} column), (TTo table, Expression{Func{TTo, string}} column), Func{QueryParts, IColumn, IColumn, QueryParts})"/>

to

/// <inheritdoc cref="QueryOptions.AddJoin"/>

Which has the advantage of being significantly easier to read - though doesn’t work when there are multiple overrides.

[zp-zpanda]

Ya, that makes sense @zp-zpanda. Thanks for the workaround. This is still a bug though, at least for this part:

the completion list will help select the member while typing the cref attribute’s value

So the completion list itself is providing a faulty completion.

Yes, this is a possible workaround but docfx doesn’t work with it for me.