Currently, header examples are lost while they are supported in OAS3. They are not designated as a lost semantic, so they should be included in header schema.
RAML 1 source
#%RAML 1.0
title: headers example
version: 1
/last-article:
get:
description: Get latest article
responses:
200:
headers:
Last-Modified-By:
description: Author of latest modification.
example: UTF-8'fr'Jean-Pierre%20Dupont
Currently, header examples are lost while they are supported in OAS3. They are not designated as a lost semantic, so they should be included in header schema.
RAML 1 source
Expected output (yaml+json)
Observed output (yaml+json)