{"action":"opened","issue":{"url":"https://api.github.com/repos/operable/cog/issues/953","repository_url":"https://api.github.com/repos/operable/cog","labels_url":"https://api.github.com/repos/operable/cog/issues/953/labels{/name}","comments_url":"https://api.github.com/repos/operable/cog/issues/953/comments","events_url":"https://api.github.com/repos/operable/cog/issues/953/events","html_url":"https://github.com/operable/cog/issues/953","id":177201624,"number":953,"title":"Document command output structure","user":{"login":"christophermaier","id":207178,"avatar_url":"https://avatars.githubusercontent.com/u/207178?v=3","gravatar_id":"","url":"https://api.github.com/users/christophermaier","html_url":"https://github.com/christophermaier","followers_url":"https://api.github.com/users/christophermaier/followers","following_url":"https://api.github.com/users/christophermaier/following{/other_user}","gists_url":"https://api.github.com/users/christophermaier/gists{/gist_id}","starred_url":"https://api.github.com/users/christophermaier/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/christophermaier/subscriptions","organizations_url":"https://api.github.com/users/christophermaier/orgs","repos_url":"https://api.github.com/users/christophermaier/repos","events_url":"https://api.github.com/users/christophermaier/events{/privacy}","received_events_url":"https://api.github.com/users/christophermaier/received_events","type":"User","site_admin":false},"labels":[{"url":"https://api.github.com/repos/operable/cog/labels/commands","name":"commands","color":"FFDCA7"}],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2016-09-15T15:01:22Z","updated_at":"2016-09-15T15:01:22Z","closed_at":null,"body":"Commands can return JSON objects, but to enable the efficient construction of pipelines, users should be able to quickly determine the structure of those objects, so they can know exactly how to extract the data they care about.\r\n\r\nA first pass at this could be providing an `OUTPUT` section in the structured documentation. Having some way to actually ensure that the documented output is the same as the generated output would be ideal, but that's likely a bigger task.\r\n\r\nRelated: #948"}}
{"actor":{"display_login":"christophermaier"}}