Vague guidelines about point query support

microsoft / api-guidelines

Microsoft REST API Guidelines

Other

22.69k stars 2.71k forks source link

Vague guidelines about point query support #511

Open corranrogue9 opened 9 months ago

corranrogue9 commented 9 months ago

The guidance for point queries:

Whenever possible, services MUST support the "/" pattern. For example:

is vague. It is unclear "whenever" a service "must" support point queries. We should either remove the "must" or we should clarify the situations when a service isn't required to support point queries.