{"action":"created","issue":{"url":"https://api.github.com/repos/dotnet/roslyn/issues/2773","repository_url":"https://api.github.com/repos/dotnet/roslyn","labels_url":"https://api.github.com/repos/dotnet/roslyn/issues/2773/labels{/name}","comments_url":"https://api.github.com/repos/dotnet/roslyn/issues/2773/comments","events_url":"https://api.github.com/repos/dotnet/roslyn/issues/2773/events","html_url":"https://github.com/dotnet/roslyn/issues/2773","id":76514459,"number":2773,"title":"Usage analysis ignores references in documentation comments","user":{"login":"sharwell","id":1408396,"avatar_url":"https://avatars1.githubusercontent.com/u/1408396?v=4","gravatar_id":"","url":"https://api.github.com/users/sharwell","html_url":"https://github.com/sharwell","followers_url":"https://api.github.com/users/sharwell/followers","following_url":"https://api.github.com/users/sharwell/following{/other_user}","gists_url":"https://api.github.com/users/sharwell/gists{/gist_id}","starred_url":"https://api.github.com/users/sharwell/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sharwell/subscriptions","organizations_url":"https://api.github.com/users/sharwell/orgs","repos_url":"https://api.github.com/users/sharwell/repos","events_url":"https://api.github.com/users/sharwell/events{/privacy}","received_events_url":"https://api.github.com/users/sharwell/received_events","type":"User","site_admin":false},"labels":[{"id":166673288,"url":"https://api.github.com/repos/dotnet/roslyn/labels/Area-Compilers","name":"Area-Compilers","color":"5319e7","default":false},{"id":165001069,"url":"https://api.github.com/repos/dotnet/roslyn/labels/Bug","name":"Bug","color":"e52727","default":false},{"id":708788933,"url":"https://api.github.com/repos/dotnet/roslyn/labels/Developer%20Community","name":"Developer Community","color":"006b75","default":false},{"id":165001072,"url":"https://api.github.com/repos/dotnet/roslyn/labels/help%20wanted","name":"help wanted","color":"0e8a16","default":true}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":{"url":"https://api.github.com/repos/dotnet/roslyn/milestones/18","html_url":"https://github.com/dotnet/roslyn/milestone/18","labels_url":"https://api.github.com/repos/dotnet/roslyn/milestones/18/labels","id":1675130,"number":18,"title":"16.0","description":"The version *after* the next major version.","creator":{"login":"gafter","id":3804346,"avatar_url":"https://avatars3.githubusercontent.com/u/3804346?v=4","gravatar_id":"","url":"https://api.github.com/users/gafter","html_url":"https://github.com/gafter","followers_url":"https://api.github.com/users/gafter/followers","following_url":"https://api.github.com/users/gafter/following{/other_user}","gists_url":"https://api.github.com/users/gafter/gists{/gist_id}","starred_url":"https://api.github.com/users/gafter/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/gafter/subscriptions","organizations_url":"https://api.github.com/users/gafter/orgs","repos_url":"https://api.github.com/users/gafter/repos","events_url":"https://api.github.com/users/gafter/events{/privacy}","received_events_url":"https://api.github.com/users/gafter/received_events","type":"User","site_admin":false},"open_issues":614,"closed_issues":100,"state":"open","created_at":"2016-03-31T00:06:25Z","updated_at":"2018-02-20T20:00:22Z","due_on":null,"closed_at":null},"comments":26,"created_at":"2015-05-14T22:42:16Z","updated_at":"2018-02-22T19:44:22Z","closed_at":null,"author_association":"MEMBER","body":"[_Migrated from CodePlex_](https://roslyn.codeplex.com/workitem/249)\n\nConsider the following class.\n\n``` csharp\nnamespace SampleNamespace\n{\n    using System;\n    using System.Threading.Tasks;\n\n    /// <summary>\n    /// Some stuff is at\n    /// <see cref=\"Task.ContinueWith(Action{Task, object}, object)\"/>.\n    /// </summary>\n    public class SampleClass\n    {\n    }\n}\n```\n\nThe behavior of **Organize Usings** varies by whether or not the current project is configured to generate an XML documentation file with the output.\n- If XML documentation file is enabled: The **Organize Usings** feature will not make any changes to the file shown above.\n- If XML documentation file is disabled: The **Organize Usings** feature will remove both of the `using` declarations in the file shown above.\n\nAt least for the purpose of analyzing `using` declarations, the behavior of Roslyn should not depend on whether or not the project is currently configured to produce an XML documentation file during the build.\n"},"comment":{"url":"https://api.github.com/repos/dotnet/roslyn/issues/comments/367797737","html_url":"https://github.com/dotnet/roslyn/issues/2773#issuecomment-367797737","issue_url":"https://api.github.com/repos/dotnet/roslyn/issues/2773","id":367797737,"user":{"login":"CyrusNajmabadi","id":4564579,"avatar_url":"https://avatars3.githubusercontent.com/u/4564579?v=4","gravatar_id":"","url":"https://api.github.com/users/CyrusNajmabadi","html_url":"https://github.com/CyrusNajmabadi","followers_url":"https://api.github.com/users/CyrusNajmabadi/followers","following_url":"https://api.github.com/users/CyrusNajmabadi/following{/other_user}","gists_url":"https://api.github.com/users/CyrusNajmabadi/gists{/gist_id}","starred_url":"https://api.github.com/users/CyrusNajmabadi/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/CyrusNajmabadi/subscriptions","organizations_url":"https://api.github.com/users/CyrusNajmabadi/orgs","repos_url":"https://api.github.com/users/CyrusNajmabadi/repos","events_url":"https://api.github.com/users/CyrusNajmabadi/events{/privacy}","received_events_url":"https://api.github.com/users/CyrusNajmabadi/received_events","type":"User","site_admin":false},"created_at":"2018-02-22T19:44:21Z","updated_at":"2018-02-22T19:44:21Z","author_association":"CONTRIBUTOR","body":"> Restricting the operation to only binding should not cause observable problems.\r\n\r\nThis sounds good to me.  It feels like we could accomplish this by augmenting CompilationOptions so that Xml handling is not just on/off.  instead there would be separate knobs for binding vs emit (with emit implying binding).  IDE would always set at least the 'bind' flag.  The 'emit' flag would be set if that was how things were specified in the proj file.\r\n\r\n--\r\n\r\nThere is an interesting wrinkle to consider though.  if we do this (naively), it's likely that you would start getting squiggles for xml doc comments, even if you didn't have the 'emit' option on.  I don't think we'd want that.  I base this on using several projects that actually have errors in this xml doc comments.  While it could be argued it would be nice if those were fixed, it's also an onerous burden we're placing on people who may not want it.   So we might need to be careful to make sure that this binding did not affect the error list/squiggles.\r\n\r\n@sharwell What are your thoughts here?"}}
{"actor":{"display_login":"CyrusNajmabadi"}}