Skip to content

Commit 3628e46

Browse files
Update docs/upgrade-guide-2.md
Co-authored-by: Martin Costello <[email protected]>
1 parent edd9ff1 commit 3628e46

File tree

1 file changed

+1
-1
lines changed

1 file changed

+1
-1
lines changed

docs/upgrade-guide-2.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,7 +59,7 @@ This API design allows a developer to use IDE autocomplete to present all the lo
5959

6060
As the YAML format is only supported when including the `Microsoft.OpenApi.YamlReader` library it was decided not to use an enum for the `format` parameter. We are considering implementing a more [strongly typed solution](https://github.com/microsoft/OpenAPI.NET/issues/1952) similar to the way that `HttpMethod` is implemented so that we have a strongly typed experience that is also extensible.
6161

62-
Where the loading methods are used without a format property, we will attempt to parse the document using the default JSON reader. If that fails and the Yaml reader is registered, then we will attempt to read as YAML. The goal is always to provide the fastest path with JSON but still maintain the convenience of not having to care whether a URL points to YAML or JSON if you need that flexibility.
62+
When the loading methods are used without a format parameter, we will attempt to parse the document using the default JSON reader. If that fails and the YAML reader is registered, then we will attempt to read as YAML. The goal is always to provide the fastest path with JSON but still maintain the convenience of not having to care whether a URL points to YAML or JSON if you need that flexibility.
6363

6464
### Removing the OpenAPI Any classes
6565

0 commit comments

Comments
 (0)