Add naming guidelines for Azure services

Open mikekistler opened this issue 3 years ago • 1 comments

This PR adds basic guidance for naming in Azure REST APIs. Some of this is borrowed from the Microsoft and Graph API guidelines and some on naming discussions we've had in prior Azure REST API reviews.

Aug 29 '22 12:08 mikekistler

Thank you for all the comments! I think I have addressed nearly all and made some other minor improvements. Please have another look.

One issue remaining is the naming convention for date-times. Do we want to recommend the "At" suffix or align with the MS and MS Graph guidelines to use a "DateTime" suffix?

Sep 01 '22 20:09 mikekistler

Thanks for all the comments and I have attempted to incorporate all these. Will be happy for any additional comments or a thumbs up if folks think this is ready to merge.

Oct 05 '22 01:10 mikekistler