Jfm/chef18 yaml recipes docs

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" >}}