Skip to content

Commit fe52062

Browse files
committed
add explicit anchors to docs (yaml)
1 parent ffd6e88 commit fe52062

File tree

1 file changed

+4
-2
lines changed
  • json-everything.net/wwwroot/md

1 file changed

+4
-2
lines changed

json-everything.net/wwwroot/md/yaml.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,14 @@
1+
# Overview {#yaml}
2+
13
Yaml2JsonNode is pretty simple: it converts models of YAML text that has been parsed by YamlDotNet into `JsonNode`s (and can also convert `JsonNode`s back into `YamlNode`s). That's it.
24

3-
## Why?
5+
## Why? {#yaml-why}
46

57
OpenAPI and indeed many JSON Schema documents are written in YAML because (I'm told) it's more human-readable than JSON. Therefore it makes sense to support YAML in the various libraries.
68

79
However, just as we let .Net handle the JSON parsing, we will let someone else handle the YAML parsing for us. Ideally, we'd want to parse directly into `JsonNode`, but conversion between models is also a very acceptable solution.
810

9-
## Using the extensions
11+
## Using the extensions {#yaml-using}
1012

1113
First, you'll need to parse the YAML. Consult [their docs](https://github.com/aaubry/YamlDotNet/wiki), of course, but a simple way is:
1214

0 commit comments

Comments
 (0)