diff --git a/internal/provider/vm_data_source.go b/internal/provider/vm_data_source.go
index 7df920a..fae0522 100644
--- a/internal/provider/vm_data_source.go
+++ b/internal/provider/vm_data_source.go
@@ -92,7 +92,7 @@ func (d *VMDataSource) Schema(ctx context.Context, req datasource.SchemaRequest,
 			},
 			"metadata": schema.MapAttribute{
 				ElementType:         types.StringType,
-				MarkdownDescription: "The amount of memory allocated to the VM instance.",
+				MarkdownDescription: "The key value pairs to associate with the VM.",
 				Optional:            true,
 			},
 			"price_hr": schema.Float64Attribute{
diff --git a/internal/provider/vm_resource.go b/internal/provider/vm_resource.go
index c67c7a7..550f74f 100644
--- a/internal/provider/vm_resource.go
+++ b/internal/provider/vm_resource.go
@@ -130,7 +130,7 @@ func (r *VMResource) Schema(ctx context.Context, req resource.SchemaRequest, res
 				PlanModifiers: []planmodifier.String{
 					stringplanmodifier.RequiresReplace(),
 				},
-				MarkdownDescription: "The maximum price per hour for the VM instance.",
+				MarkdownDescription: "The maximum price per hour for the VM instance",
 				Optional:            true,
 			},
 			"memory_gib": schema.Int64Attribute{
@@ -143,7 +143,7 @@ func (r *VMResource) Schema(ctx context.Context, req resource.SchemaRequest, res
 			"metadata": schema.MapAttribute{
 				ElementType:         types.StringType,
 				Optional:            true,
-				MarkdownDescription: "Metadata values to help you identify your virtual machine",
+				MarkdownDescription: "Metadata values to associate with the VM instance",
 			},
 			"networks": schema.ListNestedAttribute{
 				Optional:            true,