title: In Azure API Management Developer Portal, how can I display an openapi request body schema in a friendly format?
body: <p>I'm attempting to publish a API (using json-api formatting) with Azure API Management by uploading my openapi 2.0 (nee. swagger) specification.  I want to use APIM's built-in developer portal to serve documentation, but I've run into a bit of a snag with displaying the request body formatting.</p>
  
  <p>The only 'representations' available by default are 'schema' and 'sample'.  Sample is useful, but 'schema' just seems to display the 'raw' response schema, which isn't quite as nice as I'd like<sup>1</sup>.  Unfortunately, this seems to be the only way to display the 'description' for a field in a request schema.  This isn't ideal, because that description contains important context about some fields.</p>
  
  <p>Ideally, I'd like to display a table with columns identifying the field, their type, and the description from the openapi spec. I originally thought I'd be able to edit the Operation template to parse and render the information from the schema, but it appears to be passed into the template as a string - not an object that I can index into.</p>
  
  <p>Is there a way to present the field descriptions in a 'friendly' way with APIM Developer portal?</p>
  
  <p><a href="https://i.stack.imgur.com/MhKpI.png" rel="nofollow noreferrer">Schema Screensot</a> (Since I'm not allowed to post images yet :c)</p>