diff --git a/internal/provider/networking/network_broadcast_domains_data_source.go b/internal/provider/networking/network_broadcast_domains_data_source.go
index 37077982..31b4c909 100644
--- a/internal/provider/networking/network_broadcast_domains_data_source.go
+++ b/internal/provider/networking/network_broadcast_domains_data_source.go
@@ -71,7 +71,8 @@ func (d *BroadcastDomainsDataSource) Schema(ctx context.Context, req datasource.
 						Optional:            true,
 					},
 				},
-				Optional: true,
+				MarkdownDescription: "Filter broadcast domains by their properties",
+				Optional:            true,
 			},
 			"broadcast_domains": schema.ListNestedAttribute{
 				NestedObject: schema.NestedAttributeObject{
@@ -103,7 +104,8 @@ func (d *BroadcastDomainsDataSource) Schema(ctx context.Context, req datasource.
 						},
 					},
 				},
-				Computed: true,
+				MarkdownDescription: "Broadcast domains matching the filter",
+				Computed:            true,
 			},
 		},
 	}