Please note that this isn't valid JSON. The value of `required`/`readonly` has to be a boolean.. the strings I used here are comments (and marked as such), thus I left out the trailing comma. Maybe we should change it to make that clearer. Perhaps something like:

    ****"property"****: "#property", ####// The property####
    ****"required"****: true, ####// Is the property required in a request to be valid?####  
    ****"readonly"****: false, ####// Can the property's value be modified?####  
    ****"writeonly"****: true, ####// Is the property's value included in responses?####

What do you think?