[HTML2] Not making use of method examples

[Herst]

Description

Examples for parameters or return values are nowhere to be found in the resulting document.

Swagger-codegen version

2.2.1

Swagger declaration file content or url

swagger: '2.0'
info:
  version: 0.0.0
  title: Simple API
paths:
  /:
    get:
      parameters:
      - name: body
        in: body
        schema:
          type: string
          example: |
              foo
              bar
      responses:
        200:
          description: OK
          schema:
            type: string
            example: |
              foo
              bar

[wing328]

@Herst I don't think it's supported at the moment and we would definitely welcome contribution to enhancement the documentation with the examples provided in the spec.

[MartinTeeVarga]

I would like this as well. How should this look like?

There are three places where it could go:

• In the code examples (i.e. replace the apiKey_example constant with the apiKey example)
• In the pretty printed json if there are examples defined on the DTOs
• In the table that lists the parameters (not applicable for body params)

Or combination of 2 or all 3.

[wing328]

@SM4 I suggest we start with combination of 2 (1 would be most useful to me from a developer standpoint)

[nisheethagarwal]

Any update on this issue?