api-guidelines
api-guidelines copied to clipboard
microsoft
Microsoft REST API Guidelines
[Markdown Issue](https://github.com/Microsoft/api-guidelines/blob/master/Guidelines.md#12111-examples-of-group-versioning) I think it should look like that (according to the table below with _Version Format | Example | Interpretation_ headers), but I'd like to get a confirmation regarding...
Fixes https://github.com/microsoft/api-guidelines/issues/440
Thanks for creating this issue! It looks like you may be using an old version of VS Code, the latest stable release is 1.75.0. Please try upgrading to the latest...
Specifically: - DO use camel case for all query parameter names. Do not upper-case acronyms; use camel case. - exceptions: api-version (kebab case), orderby and maxpagesize (all lower) - DO...
Clarify that the JSON properties names should be in lowerCamelCase. >17.2. Casing > > Acronyms SHOULD follow the casing conventions as though they were regular words (e.g. Url). > All...
We've had a numb Add a guideline for how to handle me scenarios like Graph where it's a shortcut for the currently authenticated user. We need to provide some guidance...
There was a recent discussion around `state` and `status` to represent the current set of properties of a resource. We are settling on `status` to represent this concept.
The language around managed storage vs. BYOS should be strengthened to recommend BYOS vigorously.
A different topic. Reminded by the fix on spelling in the PR, should we have a CI to run cspell (or some other lint tool) on it? We had only...
Update the incorrect document name in the link to the "Long running operations" section of the Microsoft Graph REST API Guidelines. This correction ensures the link points to the intended...
