wordnik/swagger-ui — pull request #336 by krishgokul (2013-10-31 13:07:26+00:00)
Title: Describe each field inside sampleJSON using a tooltip

To know about each request and response field, user has to switch to "Model" and see through the fields, whereas the sample JSON is shown inside "Model Schema".
This approach has some practical difficulties, when the request model is huge with many nested classes.
In such scenarios, the user has to walk through the whole model to get detail about a particular field, as the model is shown in class structure.
Instead, if details about each field is available inside the sampleJSON itself, it will be more intuitive and useful.

To achieve this, the fields in sample JSON will have a tooltip icon near each field to display all the details available for that particular field.
In addition, fields that are NOT optional, will be shown in bold inside sample JSON, for the user to quickly identify the essential fields.
By this way, the sample JSON in "Model Schema" can be a single source of information and navigating through the "Model" will not be required.