This will likely serve as a prerequisite for #29 as well as serve as the basis for a validator.
There's work on an updated Swagger 2.0 version starting at https://github.com/open311/swagger-open311
There's also been some work on an API Blueprint version at: https://github.com/Code-for-Miami/georeport-api-blueprint/blob/master/apiary.apib
There's also been some work on an iodocs version at: https://github.com/codeforamerica/iodocs-open311/blob/master/public/data/georeport2.json