{"action":"created","issue":{"url":"https://api.github.com/repos/dotnet/roslyn/issues/9143","repository_url":"https://api.github.com/repos/dotnet/roslyn","labels_url":"https://api.github.com/repos/dotnet/roslyn/issues/9143/labels{/name}","comments_url":"https://api.github.com/repos/dotnet/roslyn/issues/9143/comments","events_url":"https://api.github.com/repos/dotnet/roslyn/issues/9143/events","html_url":"https://github.com/dotnet/roslyn/issues/9143","id":136142815,"number":9143,"title":"Proposal: Conditional summeries","user":{"login":"henrikklarup","id":5163132,"avatar_url":"https://avatars.githubusercontent.com/u/5163132?v=3","gravatar_id":"","url":"https://api.github.com/users/henrikklarup","html_url":"https://github.com/henrikklarup","followers_url":"https://api.github.com/users/henrikklarup/followers","following_url":"https://api.github.com/users/henrikklarup/following{/other_user}","gists_url":"https://api.github.com/users/henrikklarup/gists{/gist_id}","starred_url":"https://api.github.com/users/henrikklarup/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/henrikklarup/subscriptions","organizations_url":"https://api.github.com/users/henrikklarup/orgs","repos_url":"https://api.github.com/users/henrikklarup/repos","events_url":"https://api.github.com/users/henrikklarup/events{/privacy}","received_events_url":"https://api.github.com/users/henrikklarup/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2016-02-24T18:15:01Z","updated_at":"2016-02-25T09:15:54Z","closed_at":null,"body":"It would be nice to see conditional summary values, based on what value a certain parameter of the given method had.\r\nEspecially if the parameter was of type generic this could be some part of the summary replaced based on the type of the given parameter."},"comment":{"url":"https://api.github.com/repos/dotnet/roslyn/issues/comments/188683625","html_url":"https://github.com/dotnet/roslyn/issues/9143#issuecomment-188683625","issue_url":"https://api.github.com/repos/dotnet/roslyn/issues/9143","id":188683625,"user":{"login":"svick","id":287848,"avatar_url":"https://avatars.githubusercontent.com/u/287848?v=3","gravatar_id":"","url":"https://api.github.com/users/svick","html_url":"https://github.com/svick","followers_url":"https://api.github.com/users/svick/followers","following_url":"https://api.github.com/users/svick/following{/other_user}","gists_url":"https://api.github.com/users/svick/gists{/gist_id}","starred_url":"https://api.github.com/users/svick/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/svick/subscriptions","organizations_url":"https://api.github.com/users/svick/orgs","repos_url":"https://api.github.com/users/svick/repos","events_url":"https://api.github.com/users/svick/events{/privacy}","received_events_url":"https://api.github.com/users/svick/received_events","type":"User","site_admin":false},"created_at":"2016-02-25T09:15:53Z","updated_at":"2016-02-25T09:15:53Z","body":"So it's an extension to XML documentation comments? Could you explain when would this be useful?\r\n\r\nI think that documentation should not be conditional, especially since a parameter doesn't have to be a constant. In your example, if I write `someMethod(i)`, or when I'm in the middle of writing (`someMethod(`), I probably need to know all the details. Would those situations show all the conditional parts?"}}