Skip to content

Commit 686ca47

Browse files
committed
docs: adds missing mention of references resolution in the upgrade guide
Signed-off-by: Vincent Biret <vibiret@microsoft.com>
1 parent fb6cecc commit 686ca47

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
@@ -32,7 +32,7 @@ One of the key features of OpenAPI.NET is its performance. This version makes it
3232

3333
In v1, instances of `$ref` were resolved in a second pass of the document to ensure the target of the reference has been parsed before attempting to resolve it. In v2, reference targets are lazily resolved when reference objects are accessed. This improves load time performance for documents that make heavy use of references.
3434

35-
[How does this change the behavior of external references?]
35+
Because references are lazily loaded and depend on the workspace context, loading a document with unresolved references (internal or external) does not lead to an exception being thrown anymore. Instead warnings are logged in the diagnostics object. This gives you an opportunity to load additional documents in the workspace if needed, [more information](#component-registration-in-a-documents-workspace).
3636

3737
### Results
3838

0 commit comments

Comments
 (0)