We read every piece of feedback, and take your input very seriously.
To see all available qualifiers, see our documentation.
$ref
1 parent 2f46ebc commit 44aace2Copy full SHA for 44aace2
1 file changed
content/2020-12/core/ref.markdown
@@ -74,8 +74,12 @@ and not from the root of the schema.
74
{{<best-practice>}}
75
76
It is highly recommended to make use of _external_ references to break down
77
-complex monolithic schemas into smaller schema files. If you need a monolithic
78
-schema, you can automatically inline external references using the [`jsonschema
+complex monolithic schemas into smaller schema files. However, for performance
+and integrity reasons, avoid resolving these external schemas (i.e. over HTTP
79
+or the filesystem) at runtime.
80
+
81
+You can automatically inline external references at build time using the
82
+[`jsonschema
83
bundle`](https://github.com/sourcemeta/jsonschema/blob/main/docs/bundle.markdown)
84
command.
85
0 commit comments