Missing documentation for CSharp code generator

The documentation for the CSharp generator seems to be missing some comments that would be nice to see.

1. #288
2. #289
3. <remarks> comments
4. Able to specify <exception> comments such as the AutoRest validation exception.
5. Prefix ‘gets or sets’ in the comments based on the properties settings such as isReadOnly

• We’ve noticed that the other teams have ‘gets or sets’ in their descriptions for definitions since the ‘gets or sets’ comment is not being set in the model template. This will be an issue when they are generating other clients. Since the comment will not make any sense in the python client for example.

I have a fix for 5, found where the ‘get or sets’ prefix is generated in the model template and added this check. @:/// <summary> @:@WrapComment("/// ", property.IsReadOnly ? "Gets " + property.Documentation.EscapeXmlComment() : "Gets or sets " + property.Documentation.EscapeXmlComment()) @:/// </summary>

[matthchr]

@tbombach @markcowl @hovsepm @brjohnstmsft I am working on solving number 3 above.

Are you okay with the following? On operations: "summary" maps to <summary> (it already does this actually, just including it for completeness)

On models: "title" maps to <summary>, and if "title" is not specified, then "description" gets promoted to <summary> instead, to avoid breaking existing client documentation patterns which have "description" being used as the <summary> tag everywhere.

[matthchr]

@fearthecowboy – Long time coming but just wanted to confirm that you do indeed output the exception details now. Thanks!

It looks like the only remaining issue here is 2, which is also being tracked here: #289, so I think you can close this issue now.