Apiary: Is it possible to document what JSON response fields are?

Question

I would like to document what the actual JSON fields themselves represent.

I have documented the GET statement, and parameters but this does not make a complete document

Answer 1

Update: We have just rolled out a beta of attributes description using the MSON syntax.

The original payload could be then described as

### Get List of Applications [GET]

+ Response 200 (application/json)

    + Attributes
        + Catalog (object)
            + Page: 0 (number) - Number of the page
            + Count: 6 (number) - Count of *Lorem Ipsum*
            + Applications (array) - Some array of something
                + (object)
                    + UID: `6882e96a-5da1-11e3-1111-3f24f45df3ad`
                    + OtherFields

    + Body 

            {
                "Catalog" : {
                    "Page" : 0,
                    "Count" : 6,
                    "Applications" : [{
                        "UID" : "6882e96a-5da1-11e3-1111-3f24f45df3ad"
                        "OtherFields": ""
                    }]
                }
            }

Note the explicit JSON in body is redundant and you can skip it completely. See API Blueprint specification – Attributes for additional details