api-guidelines
api-guidelines copied to clipboard
Refactor the guidelines to remove swagger modeling recommendations...
There are sections of the guidelines where the "what" to do is co-mingled with the "how" to do it. Extensible Enums are one good example of this. We should consider moving this type of guidance to the Azure REST API Style Guidelines.