include swagger endpoint description in the generated doc

[nofun97]

For example this swagger:

{
	"swagger": "2.0",
	"info": {
		"title": "Sample API",
		"description": "API description in Markdown.",
		"version": "1.0.0"
	},
	"host": "api.example.com",
	"basePath": "/v1",
	"schemes": [
		"https"
	],
	"paths": {
		"/users": {
			"get": {
				"summary": "Returns a list of users.",
				"description": "Optional extended description in Markdown.",
				"produces": [
					"application/json"
				],
				"responses": {
					"200": {
						"description": "OK"
					}
				}
			}
		}
	}
}

The endpoint GET /users has a description Returns a list of users in the summary field but this information is not included in the generated doc.