40 votesMachiel Groeneveld commented
I agree, our responses are quite large and are unreadable if unformatted
You can already describe URI parameters in structured way with the new API Blueprint format. Refer to https://github.com/apiaryio/api-blueprint/blob/master/examples/7.%20Parameters.md for details.
The new format is now default and URI parameters are properly rendered in the documentation.
We are still working on description of http message–body properties (parameters). It is planned in the upcoming revision 1B of API Blueprint – as discussed in https://github.com/apiaryio/api-blueprint/issues/25Machiel Groeneveld commented
I would like to describe each parameter and give example value(s). These example values can be used to generate a sample request url, the example code (e.g. curl) now has the raw uri template code in it, which is not usable straight away