Misleading quotes in If-Match header value

Question

Misleading quotes in If-Match header value

Anonymous

There is a section in https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-odata/614ae91e-c75e-4555-9e55-d3db0c57e4cf?source=docs

The one exception to this rule is that if an If-Match header with a value of "*" is present on the request, then a data service MAY accept the request.

that the OASIS OData committee deems ambiguous. It is not clear that the double quotes are not part of the value of the If-Match header. (see https://github.com/oasis-tcs/odata-specs/issues/2156)

how to report and or fix this in the document ?

Deleted

This comment has been deleted due to a violation of our Code of Conduct. The comment was manually reported or identified through automated detection before action was taken. Please refer to our Code of Conduct for more information.

2 answers

Your answer

Deleted

This comment has been deleted due to a violation of our Code of Conduct. The comment was manually reported or identified through automated detection before action was taken. Please refer to our Code of Conduct for more information.

Answer 1

Obaid Farooqi MSFT 786 Microsoft Employee Moderator

Hi Christof:

Please ignore the AI generated response above. The proper way to have the document bug fixed is to send a request for it to dochelp at microsoft dot com. This is also listed on the first page of the MS-ODATA specification in the last paragraph https://learn.microsoft.com/en-us/openspecs/windows_protocols/ms-odata/2b686a1a-9e1f-456f-80ff-072a010fc278

Please send an email to dochelp at microsoft dot com with the question and an engineer will be in touch within 24 hours.

Regards,

Obaid Farooqi - MSFT

Obaid Farooqi MSFT 786 Reputation points Microsoft Employee Moderator

2026-05-28T15:59:40.4033333+00:00

Hi Christof:

I have alerted the open specifications team regarding your issue. A member of the team will be in touch soon.

Regards,

Obaid Farooqi - MSFT

Answer 2

KristianSmith-MSFT 531 Microsoft Employee Moderator

Hi Christof,

Thanks for reaching out with your concern regarding the MS-ODATA spec. After inspecting section 3.2.5.1, I found that the double quotes are intentionally added as a form of escape character because the entity (whether character or string) is within an English paragraph. There are many instances in the Open Specification documents that have these double quotes within paragraphs to ensure the reader knows where said character or string begins and ends.

Feel free to reach out with additional questions or concerns.

Regards,
Kristian S
Microsoft Open Specs

0 comments