describing parameters is not complete enough

[loicginoux]

The way postman let us describe all parameters is not complete enough. Only having a "description" fields to explain every details related to a parameter seems not enough.

I miss fields like "optional/mandatory", "restricted values", a "default value" field, and a "type" field. So because of that I didn't see another way than to create a markdown table in the endpoint description, see how it is displayed below:

The problem with that solution is that for larger markdown table, the documentation displayed the markdown table truncated. See another example with more detailed parameters:

Is there a way to display the whole markdown table ? How can I document parameters properly ? Thank you