Merge pull request #26836 from hashicorp/terraform-provider-descriptions

builtin/provider/terraform: Add field descriptions

builtin/providers/terraform/data_source_state.go

@@ -19,22 +19,40 @@ func dataSourceRemoteStateGetSchema() providers.Schema {
 			Attributes: map[string]*configschema.Attribute{
 				"backend": {
 					Type:            cty.String,
+					Description:     "The remote backend to use, e.g. `remote` or `http`.",
+					DescriptionKind: configschema.StringMarkdown,
 					Required:        true,
 				},
 				"config": {
 					Type: cty.DynamicPseudoType,
+					Description: "The configuration of the remote backend. " +
+						"Although this is optional, most backends require " +
+						"some configuration.\n\n" +
+						"The object can use any arguments that would be valid " +
+						"in the equivalent `terraform { backend \"<TYPE>\" { ... } }` " +
+						"block.",
+					DescriptionKind: configschema.StringMarkdown,
 					Optional:        true,
 				},
 				"defaults": {
 					Type: cty.DynamicPseudoType,
+					Description: "Default values for outputs, in case " +
+						"the state file is empty or lacks a required output.",
+					DescriptionKind: configschema.StringMarkdown,
 					Optional:        true,
 				},
 				"outputs": {
 					Type: cty.DynamicPseudoType,
+					Description: "An object containing every root-level " +
+						"output in the remote state.",
+					DescriptionKind: configschema.StringMarkdown,
 					Computed:        true,
 				},
 				"workspace": {
 					Type: cty.String,
+					Description: "The Terraform workspace to use, if " +
+						"the backend supports workspaces.",
+					DescriptionKind: configschema.StringMarkdown,
 					Optional:        true,
 				},
 			},