Basically #2 in this link: https://github.com/wordnik/swagger-js/pull/35#issuecomment-43650184 This would help keep api docs DRY.