microsoft / api-guidelines

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

Clarify: cast is not required in order to see properties of derived types. #532

Closed mikepizzo closed 4 months ago

mikepizzo commented 6 months ago

Existing wording and examples imply that a cast is required to see properties of a derived type.

Clarified wording examples, and made examples more consistent and complete.

mikepizzo commented 4 months ago

@OlgaPodo / @dkershaw10 -- Can I get you to review this? A workload owner is asking for this to be merged in order to clarify behavior for returning properties of derived types.