{"action":"created","issue":{"url":"https://api.github.com/repos/domaindrivendev/Swashbuckle/issues/217","labels_url":"https://api.github.com/repos/domaindrivendev/Swashbuckle/issues/217/labels{/name}","comments_url":"https://api.github.com/repos/domaindrivendev/Swashbuckle/issues/217/comments","events_url":"https://api.github.com/repos/domaindrivendev/Swashbuckle/issues/217/events","html_url":"https://github.com/domaindrivendev/Swashbuckle/issues/217","id":60391282,"number":217,"title":"How do I add descriptions to resources?","user":{"login":"raaga123","id":7062600,"avatar_url":"https://avatars.githubusercontent.com/u/7062600?v=3","gravatar_id":"","url":"https://api.github.com/users/raaga123","html_url":"https://github.com/raaga123","followers_url":"https://api.github.com/users/raaga123/followers","following_url":"https://api.github.com/users/raaga123/following{/other_user}","gists_url":"https://api.github.com/users/raaga123/gists{/gist_id}","starred_url":"https://api.github.com/users/raaga123/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/raaga123/subscriptions","organizations_url":"https://api.github.com/users/raaga123/orgs","repos_url":"https://api.github.com/users/raaga123/repos","events_url":"https://api.github.com/users/raaga123/events{/privacy}","received_events_url":"https://api.github.com/users/raaga123/received_events","type":"User","site_admin":false},"labels":[],"state":"closed","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-03-09T18:50:02Z","updated_at":"2015-03-10T05:41:15Z","closed_at":"2015-03-10T05:41:15Z","body":"Our API is up and running well, but I haven't figured out how to add a description to each resource. Using the \"summary\" tag works for operations, but doesn't seem to work for resources.\r\n\r\n(Sorry about the naive question, but I'm at my wits' end here.)\r\n\r\nThanks,\r\n    -- Lyn"},"comment":{"url":"https://api.github.com/repos/domaindrivendev/Swashbuckle/issues/comments/77998946","html_url":"https://github.com/domaindrivendev/Swashbuckle/issues/217#issuecomment-77998946","issue_url":"https://api.github.com/repos/domaindrivendev/Swashbuckle/issues/217","id":77998946,"user":{"login":"domaindrivendev","id":1434343,"avatar_url":"https://avatars.githubusercontent.com/u/1434343?v=3","gravatar_id":"","url":"https://api.github.com/users/domaindrivendev","html_url":"https://github.com/domaindrivendev","followers_url":"https://api.github.com/users/domaindrivendev/followers","following_url":"https://api.github.com/users/domaindrivendev/following{/other_user}","gists_url":"https://api.github.com/users/domaindrivendev/gists{/gist_id}","starred_url":"https://api.github.com/users/domaindrivendev/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/domaindrivendev/subscriptions","organizations_url":"https://api.github.com/users/domaindrivendev/orgs","repos_url":"https://api.github.com/users/domaindrivendev/repos","events_url":"https://api.github.com/users/domaindrivendev/events{/privacy}","received_events_url":"https://api.github.com/users/domaindrivendev/received_events","type":"User","site_admin":false},"created_at":"2015-03-10T05:41:15Z","updated_at":"2015-03-10T05:41:15Z","body":"In Swagger 2.0, each Operation is assigned one or more arbitrary Tags. The swagger-ui then uses the first tag of each Operation to group them in the UI. By default, SB sets \"controller name\" as a tag on each Operation, hence why you see the operations grouped by controller name.\r\n\r\nHowever, from a Swagger perspective, this can be any arbitrary string you like. Instead of \"controller name\", you can assign your own custom grouping key (even one that includes a description). Check out the __GroupActionsBy__ config option for more details."}}