Jfm/chef18 yaml recipes docs (#4469)

* Adding docs for yaml recipes

Signed-off-by: John McCrae <[email protected]>

* Adding docs for yaml recipes

Signed-off-by: John McCrae <[email protected]>

* Quick fixes

Signed-off-by: Ian Maddaus <[email protected]>

* Editing

Signed-off-by: Ian Maddaus <[email protected]>

* More editing

Signed-off-by: Ian Maddaus <[email protected]>

* More editing

Signed-off-by: Ian Maddaus <[email protected]>

* Add JSON recipes

Signed-off-by: Ian Maddaus <[email protected]>

* One more change

Signed-off-by: Ian Maddaus <[email protected]>

* Fix linting issues

Signed-off-by: Ian Maddaus <[email protected]>

* Add recipe support versions

Signed-off-by: Ian Maddaus <[email protected]>

---------

Signed-off-by: John McCrae <[email protected]>
Signed-off-by: Ian Maddaus <[email protected]>
Co-authored-by: Ian Maddaus <[email protected]>

Author: johnmccrae

content/debug.md

@@ -9,7 +9,7 @@ aliases = ["/debug.html"]
     title = "Debug Recipes, Client Runs"
     identifier = "chef_infra/cookbook_reference/recipes/debug.md Debug Recipes, Client Runs"
     parent = "chef_infra/cookbook_reference/recipes"
-    weight = 20
+    weight = 30
 +++
 
 Elements of good approaches to building cookbooks and recipes that are

content/recipes.md

@@ -14,6 +14,12 @@ aliases = ["/recipes.html", "essentials_cookbook_recipes.html"]
 
 {{< readfile file="content/reusable/md/cookbooks_recipe.md" >}}
 
+## YAML and JSON recipes
+
+{{< readfile file = "content/reusable/md/recipes_yaml_json_overview.md" >}}
+
+See the [YAML and JSON recipe documentation]({{< relref "recipes_json_yaml" >}}) for more information.
+
 ## Recipe Attributes
 
 {{< readfile file="content/reusable/md/cookbooks_attribute.md" >}}