{"action":"created","issue":{"url":"https://api.github.com/repos/Swagger2Markup/swagger2markup-cli/issues/4","labels_url":"https://api.github.com/repos/Swagger2Markup/swagger2markup-cli/issues/4/labels{/name}","comments_url":"https://api.github.com/repos/Swagger2Markup/swagger2markup-cli/issues/4/comments","events_url":"https://api.github.com/repos/Swagger2Markup/swagger2markup-cli/issues/4/events","html_url":"https://github.com/Swagger2Markup/swagger2markup-cli/issues/4","id":122762966,"number":4,"title":"How to use the -e option?","user":{"login":"dsem","id":2773346,"avatar_url":"https://avatars.githubusercontent.com/u/2773346?v=3","gravatar_id":"","url":"https://api.github.com/users/dsem","html_url":"https://github.com/dsem","followers_url":"https://api.github.com/users/dsem/followers","following_url":"https://api.github.com/users/dsem/following{/other_user}","gists_url":"https://api.github.com/users/dsem/gists{/gist_id}","starred_url":"https://api.github.com/users/dsem/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dsem/subscriptions","organizations_url":"https://api.github.com/users/dsem/orgs","repos_url":"https://api.github.com/users/dsem/repos","events_url":"https://api.github.com/users/dsem/events{/privacy}","received_events_url":"https://api.github.com/users/dsem/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":1,"created_at":"2015-12-17T15:53:12Z","updated_at":"2015-12-17T17:01:56Z","closed_at":null,"body":"for the `-e` option, the help says:\r\n\r\n```\r\n-e <examplesPath>\r\n    Include examples into the Paths document\r\n```\r\n\r\nWhat is this `<examplesPath>`?\r\n* Is it the path where the output examples file should go?  The description days it will be included in the Paths document, so it shouldn't need it's own output path.\r\n* Is it the path where the input example file is? Aren't examples supposed to be in-line with responses in the swagger-spec, and thus, not have their own input file?  For example,\r\n```\r\nresponses:\r\n  '200':\r\n    description: OK\r\n      schema:\r\n        $ref: '#/definitions/Response'\r\n      examples:\r\n        application/json:\r\n          field1: 23\r\n          field2: 81533\r\n          field3: 83288\r\n          field4: 2440\r\n```"},"comment":{"url":"https://api.github.com/repos/Swagger2Markup/swagger2markup-cli/issues/comments/165513463","html_url":"https://github.com/Swagger2Markup/swagger2markup-cli/issues/4#issuecomment-165513463","issue_url":"https://api.github.com/repos/Swagger2Markup/swagger2markup-cli/issues/4","id":165513463,"user":{"login":"RobWin","id":5815046,"avatar_url":"https://avatars.githubusercontent.com/u/5815046?v=3","gravatar_id":"","url":"https://api.github.com/users/RobWin","html_url":"https://github.com/RobWin","followers_url":"https://api.github.com/users/RobWin/followers","following_url":"https://api.github.com/users/RobWin/following{/other_user}","gists_url":"https://api.github.com/users/RobWin/gists{/gist_id}","starred_url":"https://api.github.com/users/RobWin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/RobWin/subscriptions","organizations_url":"https://api.github.com/users/RobWin/orgs","repos_url":"https://api.github.com/users/RobWin/repos","events_url":"https://api.github.com/users/RobWin/events{/privacy}","received_events_url":"https://api.github.com/users/RobWin/received_events","type":"User","site_admin":false},"created_at":"2015-12-17T17:01:56Z","updated_at":"2015-12-17T17:01:56Z","body":"Hi,\r\nits primary to include example HTTP request and response snippets.\r\nI have developed it because I use Springfox and spring-restdocs.\r\nSee https://swagger2markup.readme.io/docs/spring-restdocs at the bottom."}}