Skip to content

Commit ba89998

Browse files
committed
make the note part of the main text instead of just a tip
1 parent 2fee432 commit ba89998

File tree

2 files changed

+4
-2
lines changed

2 files changed

+4
-2
lines changed

.jekyll-metadata

2.09 KB
Binary file not shown.

_docs/schema/basics.md

+4-2
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,9 @@ There are two options when building a schema: defining it inline using the fluen
4747

4848
## Serialization and Deserialization {#schema-deserialization}
4949

50-
_JsonSchema.Net_ schemas are fully serializable.
50+
Serialization is how we convert between the textual representation of JSON Schema and a `JsonSchema` .Net object. In many cases, you'll compose your schemas in separate JSON files and deserialize them into the `JsonSchema` model. However if you [define your schemas in code](#schema-inlining) or [generate them from a type](/schema/schemagen/schema-generation/) you won't have a textual representation of those schemas on hand.
51+
52+
To facilitate this, _JsonSchema.Net_ schemas are fully serializable.
5153

5254
```c#
5355
var mySchema = JsonSchema.FromText(content);
@@ -61,7 +63,7 @@ var mySchema = JsonSerializer.Deserialize<JsonSchema>(content);
6163

6264
Done.
6365

64-
> Serialization is the mechanic used to obtain a textual representation of a `JsonSchema` object. This may be necessary if you, for example, [define your schemas in code](#schema-inlining) or [generate them from a type](/schema/schemagen/schema-generation/). You can either use the JSON serializer as shown above, or the YAML serializer found in [_Yaml2JsonNode_](/yaml/basics/).
66+
> You can either use the JSON serializer as shown above, or the YAML serializer found in [_Yaml2JsonNode_](/yaml/basics/).
6567
{: .prompt-tip}
6668

6769
### Ahead of Time (AOT) compatibility {#aot}

0 commit comments

Comments
 (0)