Summary of examples removed

[majoshi1]

The summary of examples was removed in v9.1.4. It has been working fine till v9.1.3/api-request.js#L248. Is there a way to achieve it in v9.1.4? If not, is it possible to revert the change?

	"parameters": [{
			"name": "someName",
			"schema": {},
			"examples": {
				"example1": {
					"summary": "Item1",
					"value": "10"
				}
			}
		}

	]
}

[mrin9]

The summary of examples was removed in v9.1.4

where, you mean when listing them it now uses value instead of summary ?

[majoshi1]

Yes. Below are the lines from both versions for comparison:

1. Shows summary (v9.1.3)

v9.1.3/api-request.js#L248

>${v.description || v.summary || v.value}</a>

---

2. Does not show summary (v9.1.4)

v9.1.4/api-request.js#L249

>${v.value && Array.isArray(v.value) ? (v.value?.join(', ')) : (v.value || '')}</a>

[majoshi1]

Any update here please? Can't update to latest version, until this defect is fixed.

[mrin9]

this was done as we received many user feedback stating its better to show the actual values than summary for examples
I will check if I can provide any options for both possibilities.

[majoshi1]

How about vendor extension?
e.g. x-example-summary-show : no for each parameter to indicate if summary should be used. Also may be RapiDoc attribute show-examples-summary = true/false to indicate for the entire spec.

[mrin9]

use use-summary-to-list-example = true to list example summary instead of value (default is false)