DO NOT MERGE - restructure language reference

website/data/language-nav-data.json

@@ -70,75 +70,33 @@
     ]
   },
   {
-    "title": "Resources",
+    "title": "Create resources",
     "routes": [
-      { "title": "Overview", "path": "resources" },
-      { "title": "Resource Blocks", "path": "resources/syntax" },
+      { "title": "Overview", "path": "create-resource" },
       {
-        "title": "Resource Behavior",
-        "path": "resources/behavior"
-      },
-      {
-        "title": "Meta-Arguments",
+        "title": "Apply provisioners",
         "routes": [
           {
-            "title": "<code>depends_on</code>",
-            "href": "/language/meta-arguments/depends_on"
-          },
-          {
-            "title": "<code>count</code>",
-            "href": "/language/meta-arguments/count"
-          },
-          {
-            "title": "<code>for_each</code>",
-            "href": "/language/meta-arguments/for_each"
+            "title": "Overview",
+            "path": "create-resource/provisioners"
           },
-          {
-            "title": "<code>provider</code>",
-            "href": "/language/meta-arguments/resource-provider"
-          },
-          {
-            "title": "<code>lifecycle</code>",
-            "href": "/language/meta-arguments/lifecycle"
-          }
-        ]
-      },
-      {
-        "title": "Provisioners",
-        "routes": [
           {
             "title": "Declaring Provisioners",
-            "path": "resources/provisioners/syntax"
+            "path": "create-resource/provisioners/define"
           },
           {
             "title": "Provisioner Connections",
-            "path": "resources/provisioners/connection"
-          },
-          {
-            "title": "Provisioners Without a Resource",
-            "path": "resources/provisioners/null_resource"
-          },
-          {
-            "title": "file",
-            "path": "resources/provisioners/file"
-          },
-          {
-            "title": "local-exec",
-            "path": "resources/provisioners/local-exec"
+            "path": "create-resource/provisioners/connect"
           },
           {
-            "title": "remote-exec",
-            "path": "resources/provisioners/remote-exec"
+            "title": "Run commands on standard lifecycle resources",
+            "path": "create-resource/provisioners/null_resource"
           }
         ]
       },
       {
-        "title": "The <code>terraform_data</code> Resource Type",
-        "path": "resources/terraform-data"
-      },
-      {
-        "title": "Ephemeral Resources",
-        "path": "resources/ephemeral"
+        "title": "Apply standard lifecycle",
+        "path": "create-resource/terraform-data"
       }
     ]
   },
@@ -257,6 +215,14 @@
       }
     ]
   },
+  {
+    "title": "Resource block",
+    "path": "resource"
+  },
+  {
+    "title": "Ephemeral block",
+    "path": "ephemeral"
+  },
   {
     "title": "Moved block",
     "path": "moved"
@@ -265,6 +231,10 @@
     "title": "Terraform block",
     "path": "terraform"
   },
+  {
+    "title": "Provisioner block",
+    "path": "provisioner"
+  },
   {
     "title": "Backend block",
     "routes": [

website/docs/language/resources/behavior.mdx → website/docs/language/create-resource/index.mdx

@@ -1,11 +1,14 @@
 ---
-page_title: Resource Behavior - Configuration Language
+page_title: Manage resources in Terraform configuration language
 description: >-
-  Learn how Terraform uses resource blocks to create infrastructure objects.
-  Also learn about resource dependencies and how to access resource attributes.
+  Resource blocks define real-world resources. Learn how to define resource blocks to create and manage infrastructure resources with Terraform.
 ---
 
-# Resource Behavior
+# Manage resources in Terraform configuration language
+
+This topic provides an overview of the Terraform `resource` block.
+
+## Introduction
 
 A `resource` block declares that you want a particular infrastructure object
 to exist with the given settings. If you are writing a new configuration for

website/docs/language/resources/provisioners/null_resource.mdx → website/docs/language/create-resource/provisioners/null_resource.mdx

@@ -5,7 +5,7 @@ description: >-
   are not directly associated with a single existing resource.
 ---
 
-# Provisioners Without a Resource
+# Run commands on standard lifecycle resources
 
 If you need to run provisioners that aren't directly associated with a specific
 resource, you can associate them with a `terraform_data`.

website/docs/language/resources/terraform-data.mdx → website/docs/language/create-resource/terraform-data.mdx

@@ -1,13 +1,18 @@
 ---
-page_title: The terraform_data Managed Resource Type
+page_title: Apply the standard Terraform resource lifecycle
 description: >-
   Retrieves the root module output values from a Terraform state snapshot stored
   in a remote backend.
 ---
 
-# The `terraform_data` Managed Resource Type
+# Apply the standard Terraform resource lifecycle
+
+This topic describes how to configure resources to follow the standard Terraform resource lifecycle. 
+
+## Configure the `terraform_data` resource type
+
+The `terraform_data` resource type implements the standard resource lifecycle for the resource but does not directly take any other actions. 
 
-The `terraform_data` implements the standard resource lifecycle, but does not directly take any other actions. 
 You can use the `terraform_data` resource without requiring or configuring a provider. It is always available through a built-in provider with the [source address](/terraform/language/providers/requirements#source-addresses) `terraform.io/builtin/terraform`.
 
 The `terraform_data` resource is useful for storing values which need to follow a manage resource lifecycle, and for triggering provisioners when there is no other logical managed resource in which to place them.