search

microsoft / api-guidelines

Microsoft REST API Guidelines
Other
22.69k stars 2.71k forks source link

Restructure and strengthen guidance on conditional requests #461

Closed mikekistler closed 1 year ago

mikekistler commented 1 year ago

This PR restructures and updates the guidance for processing of conditional requests.

The primary motivation for this update is the research that I did on the conditional headers for #458. This led me to realize that we needed to strengthen our guidance so that services would correctly handle these headers whenever they are present.

I also moved much of the explanatory content to a new section in ConsiderationsForServiceDesign, so that the section in the Guidelines could be kept to just the direct and actionable guidance.

heaths commented 1 year ago

@markweitzel can you merge this? Board agrees it's ready.