swagger-js model renderer does not parse/display model description

[mohsen1]

swagger-api/swagger-ui#406

[fehguy]

I believe this used to work, must be a regression.

[whitlockjc]

I just went back through the code, the last master merge from develop_2.0 before I got involved. The model description was never displayed prior so this is a new feature, not a regression.

[fehguy]

I propose we move this to a future swagger-ui release, where the rendering will live in the UI code, not JS.

swagger-api/swagger-ui#1248

[HolgerVogelsang]

I'ts not rocket science:

1. Open swagger-ui.js
2. Search for function processModel(schema, name)
3. Change the first lines of this function to something like this (or whatever you want to display):

  function processModel(schema, name) {
    var type = schema.type || 'object';
    var isArray = schema.type === 'array';

    var html = schema.description !== undefined ? '<div style=\'margin-left: 0px; font-size: 14px;\'>' + strongOpen + '// ' + schema.description + strongClose + '</div>' : '';
    html += (strongOpen + name + ' ' + (isArray ? '[' : '{') + strongClose);