Parameters: Description of enumeration elements

[honzajavorek]

Currently, only

+ Values
    + `A`
    + `B`
    + `C`

works. However, people want (1, 2) to document such values separately. Let's say, they want something like

+ Values
    + `A` ... means something
    + `B` ... means something else
    + `C` ... means something completely different

(Just made up the syntax, please do not take it as a real proposal - I assume we need to evaluate the feature request first.)

[zdne]

This is planned.

[pksunkara]

When we align parameters syntax to MSON, this should be achieved by

- country (enum[string])
    - `CZE` - Czech Republic
    - `IND` - India

[zdne]

RFC proposal of syntax addressing this issue: apiaryio/api-blueprint-rfcs#3.

Please track and comment on the RFC.

Thank you!