docs: clarify coder_metadata usage

ethanndickson · ethanndickson · commit 19dd4704485d · 2024-08-14T04:15:15.000Z
diff --git a/provider/metadata.go b/provider/metadata.go
@@ -14,7 +14,8 @@ func metadataResource() *schema.Resource {
 		SchemaVersion: 1,
 
 		Description: "Use this resource to attach metadata to a resource. They will be " +
-			"displayed in the Coder dashboard.",
+			"displayed in the Coder dashboard alongside the resource. To attach metadata " +
+			"to an entire workspace, use a `metadata` block within a `coder_agent` resource.",
 		CreateContext: func(c context.Context, resourceData *schema.ResourceData, i interface{}) diag.Diagnostics {
 			resourceData.SetId(uuid.NewString())
 
