chore(docs): improve docs for image_v2 and machine_type (#977)

* chore(docs): improve docs for image_v2 and machine_type

Signed-off-by: Mauritz Uphoff <mauritz.uphoff@stackit.cloud>

* review changes

Signed-off-by: Mauritz Uphoff <mauritz.uphoff@stackit.cloud>

---------

Signed-off-by: Mauritz Uphoff <mauritz.uphoff@stackit.cloud>

stackit/internal/services/iaas/imagev2/datasource.go

@@ -178,6 +178,10 @@ func (d *imageDataV2Source) Schema(_ context.Context, _ datasource.SchemaRequest
 			"    ignore_changes = [boot_volume[0].source_id]\n"+
 			"  }\n"+
 			"}\n"+
+			"```\n\n"+
+			"You can also list available images using the [STACKIT CLI](https://github.com/stackitcloud/stackit-cli):\n\n"+
+			"```bash\n"+
+			"stackit image list\n"+
 			"```",
 	), core.Datasource)
 	resp.Schema = schema.Schema{

stackit/internal/services/iaas/machinetype/datasource.go

@@ -92,15 +92,17 @@ func (d *machineTypeDataSource) Schema(_ context.Context, _ datasource.SchemaReq
 				Optional:    true,
 			},
 			"filter": schema.StringAttribute{
-				Description: `Expr-lang filter for filtering machine types.
-
-Examples:
-- vcpus == 2
-- ram >= 2048
-- extraSpecs.cpu == "intel-icelake-generic"
-- extraSpecs.cpu == "intel-icelake-generic" && vcpus == 2
-
-See https://expr-lang.org/docs/language-definition for syntax.`,
+				Description: "Expr-lang filter for filtering machine types.\n\n" +
+					"Examples:\n" +
+					"- vcpus == 2\n" +
+					"- ram >= 2048\n" +
+					"- extraSpecs.cpu == \"intel-icelake-generic\"\n" +
+					"- extraSpecs.cpu == \"intel-icelake-generic\" && vcpus == 2\n\n" +
+					"Syntax reference: https://expr-lang.org/docs/language-definition\n\n" +
+					"You can also list available machine-types using the [STACKIT CLI](https://github.com/stackitcloud/stackit-cli):\n\n" +
+					"```bash\n" +
+					"stackit server machine-type list\n" +
+					"```",
 				Required: true,
 			},
 			"description": schema.StringAttribute{