Best pattern/practice to describe a JWT token content on SwaggerHub

Hi HenrikHL ,

You could consider to describe the payload claims using markdown in the description and present either as a JSON example or as a table (or indeed both).

Example:

    envelope:
      type: string
      maxLength: 1500
      description: |
        A JWT token (_header_._payload_._signature_) with the following `payload` claims structure:
        ```
        {
          "name": "John Doe",
          "admin": true
        }
        ```
        Claims Details:
        
        |Claim|Type|Example|
        |-----|----|-------|
        |name|`string`|"John Doe"|
        |admin|`boolean`|true|
        
        
      example: 'xxxxx.yyyyy.zzzzz'  

Hope this helps.