Mike Kistler

All good questions! We'll try to get these clarified in the next round of guidelines updates.

Actually, "if-modified-since"/ "if-unmodified-since" are also clearly defined in RFC 7232 as an "HTTP date" -- RCF 1123. https://datatracker.ietf.org/doc/html/rfc7232#section-3.3

Capturing a comment from a side discussion on this topic: > as an example of RFC 822's [the basis of RFC 1123] horribleness to work with, it allows timezones like...

A closer reading of RFC 7231 shows that it recommends (but does not mandate) that date-times always be expressed in GMT: > The preferred format is a fixed-length and **single-zone...

@JeffreyRichter recommends: - Enum casing MUST be camelCase - Enum matching MUST be case-sensitive

Despite the fact that I posted it on April 1, it was not a joke. I'm sure we discussed this and @JeffreyRichter (among others) recommended we go with camelCase (not...

I reached out to @vladimirjoanovic for a pointer to the RP/ARM API Guidelines. Here's his response: > Our guidance/RPC is on aka.ms/armwiki and aka.ms/rpapiv2

Using information from: - [OpenAPI Specifications Authoring - Automated Guidelines](https://github.com/Azure/azure-rest-api-specs/blob/master/documentation/openapi-authoring-automated-guidelines.md) and - [OpenAPI Specifications Authoring - Manual Guidelines](https://github.com/Azure/azure-rest-api-specs/blob/master/documentation/openapi-authoring-manual-guidelines.md) I recommend that we add the following to our Azure API Guidelines:
...

There was a question raised in a recent API review on consistency of the Azure API guidelines vs ARM guidelines on whether URL path segments should be treated as case-sensitive...

The [Azure SDK Guidelines](https://azure.github.io/azure-sdk/general_design.html#service-api-versions:~:text=%E2%9C%85%20DO%20add%20or%20replace%20the%20api%2Dversion%20query%20parameter%20on%20any%20URI%20returned%20by%20the%20service%20e.g.%2C%20Operation%2DLocation%2C%20next%20page%20links%2C%20etc.%2C%20with%20the%20service%20version%20passed%20configured%20on%20the%20client.) are already very clear on this point. > [✅](https://azure.github.io/azure-sdk/general_design.html#general-service-apiversion-7) DO add or replace the api-version query parameter on any URI returned by the service e.g., Operation-Location,...