format_path(swagger, subPath, path, method, operation) ::= <<
<format_title(swagger, method, subPath)>
<format_description(operation)>
<if(operation.parameters)><format_parameters(operation.parameters)><endif>
<format_responses(operation)>

>>

format_title(swagger, method, subPath) ::= "==== <method> <swagger.basePath><subPath>"

format_description(operation) ::= "===== Description<\n><operation.description>"

format_parameters(parameters) ::= <<===== Parameters
[options="header"]
|===
|Where|Name|Description|Required|Schema|Default
<parameters:format_parameter()>|===

>>

format_parameter(p) ::= "|<p.in>|<p.name>|<p.description>|<p.required>|<format_parameter_type(p)>|<p.defaultValue><\n>"

format_parameter_type(p) ::= "<if (p.type)><p.type><elseif(p.schema)>\<\<<p.schema.simpleRef>>><endif>"

format_responses(operation) ::= <<===== Responses
[options="header"]
|===
|HTTP Code|Description|Schema
<operation.responses.keys:{
k | |<k>|<operation.responses.(k).description>|<format_response_type(operation.responses.(k).schema)><\n>}>|===
>>

format_response_type(p) ::= "<if (p.items)>[\<\<<p.items.simpleRef>>>]<elseif(p.simpleRef)>\<\<<p.simpleRef>>><endif>"