Reference operators in XML documentation
<p>I would like to reference an operator in a <code>&lt;see cref=&quot;...&quot; /&gt;</code> <a href="https://msdn.microsoft.com/en-us/library/b2s063f7.aspx" rel="noreferrer">XML documentation</a> tag, but I can't seem to find any hints on how to do it. The <a href="https://msdn.microsoft.com/en-us/library/acd0tfbe.aspx" rel="noreferrer">MSDN article</a> on this tag only shows a simple example referencing a method, but does not go over different types of members that can be referenced.</p>
<p>In particular, I would like to reference an <strong>implicit conversion operator</strong>, but general rule for referencing operators will also be appreciated.</p>
<hr />
<h1>Example</h1>
<p>Let's say we have a simple structure for which we define <code>==</code>, <code>!=</code> and implicit conversion operators:</p>
<pre><code>public struct MyStructure
{
    public int Value { get; set; }

    public static bool operator ==(MyStructure x, MyStructure y) =&gt; x.Value == y.Value;

    public static bool operator !=(MyStructure x, MyStructure y) =&gt; x.Value != y.Value;

    public static implicit operator MyStructure(int i) =&gt; new MyStructure { Value = i };
}
</code></pre>
<p>Simply enough one can reference the <code>Value</code> property with <code>&lt;see cref=&quot;MyStructure.Value&quot; /&gt;</code>, but how to go about referencing the <code>==</code> operator? I obviously tried <code>&lt;see cref=&quot;MyStructure.==&quot; /&gt;</code> and <code>&lt;see cref=&quot;MyStructure.==(MyStructure, MyStructure)&quot; /&gt;</code> but I don't think this works as it should because of these two observations:</p>
<ol>
<li>The operator is not coloured in the tooltip showing a summary as opposed to other members being coloured when properly referenced</li>
<li>The <em>Go to definition</em> command does not work whereas it does for other properly referenced members</li>
</ol>
<p>I also suspect tools like <a href="http://sandcastle.codeplex.com/" rel="noreferrer">Sandcastle</a> used to generate <em>HTML</em> pages based on the <em>XML documentation</em> would not produce valid hyperlinks either, but that remains to be confirmed.</p>
<p><strong>EDIT</strong></p>
<p>I just confirmed that <em>Sandcastle</em> does not produce valid hyperlinks for any of my attempts. Also, when the option to generate the <em>XML documentation</em> in the project properties is checked, a warning with code <strong><em>CS1584</em></strong> is shown saying &quot;<em>XML comment has syntactically incorrect cref attribute 'MyStructure.=='</em>&quot;.</p>
<hr />
<h1>Justification</h1>
<p>In case someone is wondering why do I want to reference an operator the answer is I am writing a unit test method performing tests on an operator and as a general rule I put references to tested members in the <em>XML documentation</em> for the test method. So what I'm after is this:</p>
<pre><code>/// &lt;summary&gt;
/// This method performs tests regarding &lt;see cref=&quot;...&quot; /&gt; operator
/// &lt;/summary&gt;
[TestMethod]
public void ImplicitConversionOperator() { ... }
</code></pre>