MSGraph-SDK-Code-Generator icon indicating copy to clipboard operation
MSGraph-SDK-Code-Generator copied to clipboard

XML comments within code comments are not correct in c#

Open ksikorsk opened this issue 6 years ago • 1 comments

Annotation:

<Annotations Target="microsoft.graph.cloudCommunications/calls">
  <Annotation Term="Org.OData.Core.V1.Description" String="Gets or sets the list of &lt;see cref=&quot;T:Microsoft.Graph.Call&quot; /&gt; for this application." />
</Annotations>

Expected code comment:

/// <summary>
/// Gets or sets the list of <see cref="T:Microsoft.Graph.Call" /> for this application.
/// </summary>
[JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "calls", Required = Newtonsoft.Json.Required.Default)]
public ICloudCommunicationsCallsCollectionPage Calls { get; set; }

Current code comment:

/// <summary>
/// Gets or sets calls.
/// Gets or sets the list of &amp;lt;see cref="T:Microsoft.Graph.Call" /&amp;gt; for this application.
/// </summary>
[JsonProperty(NullValueHandling = NullValueHandling.Ignore, PropertyName = "calls", Required = Newtonsoft.Json.Required.Default)]
public ICallsApplicationCallsCollectionPage Calls { get; set; }

AB#7105

ksikorsk avatar Aug 07 '19 17:08 ksikorsk

Started some work for documentation annotations. https://github.com/microsoftgraph/MSGraph-SDK-Code-Generator/pull/211

ksikorsk avatar Aug 07 '19 17:08 ksikorsk

C# development moved to kiota

zengin avatar Apr 05 '23 20:04 zengin