{"action":"created","issue":{"url":"https://api.github.com/repos/Azure/autorest/issues/981","repository_url":"https://api.github.com/repos/Azure/autorest","labels_url":"https://api.github.com/repos/Azure/autorest/issues/981/labels{/name}","comments_url":"https://api.github.com/repos/Azure/autorest/issues/981/comments","events_url":"https://api.github.com/repos/Azure/autorest/issues/981/events","html_url":"https://github.com/Azure/autorest/issues/981","id":151230557,"number":981,"title":"Missing documentation for CSharp code generator","user":{"login":"brnleehng","id":5770004,"avatar_url":"https://avatars.githubusercontent.com/u/5770004?v=3","gravatar_id":"","url":"https://api.github.com/users/brnleehng","html_url":"https://github.com/brnleehng","followers_url":"https://api.github.com/users/brnleehng/followers","following_url":"https://api.github.com/users/brnleehng/following{/other_user}","gists_url":"https://api.github.com/users/brnleehng/gists{/gist_id}","starred_url":"https://api.github.com/users/brnleehng/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/brnleehng/subscriptions","organizations_url":"https://api.github.com/users/brnleehng/orgs","repos_url":"https://api.github.com/users/brnleehng/repos","events_url":"https://api.github.com/users/brnleehng/events{/privacy}","received_events_url":"https://api.github.com/users/brnleehng/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/Azure/autorest/labels/enhancement","name":"enhancement","color":"84b6eb"}],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":4,"created_at":"2016-04-26T20:24:43Z","updated_at":"2016-06-14T01:07:42Z","closed_at":null,"body":"The documentation for the CSharp generator seems to be missing some comments that would be nice to see.\r\n\r\n1) #288 \r\n2) #289 \r\n3) `<remarks>` comments\r\n4) Able to specify `<exception>` comments such as the AutoRest validation exception. \r\n5) Prefix 'gets or sets' in the comments based on the properties settings such as isReadOnly\r\n- 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. \r\n\r\nI have a fix for 5, found where the 'get or sets' prefix is generated in the model template and added this check. \r\n`        @:/// <summary>\r\n        @:@WrapComment(\"/// \", property.IsReadOnly ? \"Gets \" + property.Documentation.EscapeXmlComment() : \"Gets or sets \" + property.Documentation.EscapeXmlComment())\r\n        @:/// </summary> `"},"comment":{"url":"https://api.github.com/repos/Azure/autorest/issues/comments/225753432","html_url":"https://github.com/Azure/autorest/issues/981#issuecomment-225753432","issue_url":"https://api.github.com/repos/Azure/autorest/issues/981","id":225753432,"user":{"login":"matthchr","id":8798850,"avatar_url":"https://avatars.githubusercontent.com/u/8798850?v=3","gravatar_id":"","url":"https://api.github.com/users/matthchr","html_url":"https://github.com/matthchr","followers_url":"https://api.github.com/users/matthchr/followers","following_url":"https://api.github.com/users/matthchr/following{/other_user}","gists_url":"https://api.github.com/users/matthchr/gists{/gist_id}","starred_url":"https://api.github.com/users/matthchr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/matthchr/subscriptions","organizations_url":"https://api.github.com/users/matthchr/orgs","repos_url":"https://api.github.com/users/matthchr/repos","events_url":"https://api.github.com/users/matthchr/events{/privacy}","received_events_url":"https://api.github.com/users/matthchr/received_events","type":"User","site_admin":false},"created_at":"2016-06-14T01:07:42Z","updated_at":"2016-06-14T01:07:42Z","body":"Alright, see: #1148 for fix to item 3 (support of remarks)"}}
{"actor":{"display_login":"matthchr"}}