Merge pull request #417 from Juniper/415-reconfigure-provider-documen…

…tation reconfigure docs for better ordering
Juniper · Oct 25, 2023 · 74194d2 · 74194d2
2 parents 0c2e7cc + 2e16f8e
commit 74194d2
Show file tree

Hide file tree

Showing 187 changed files with 312 additions and 184 deletions.
diff --git a/apstra/constants.go b/apstra/constants.go
@@ -16,4 +16,12 @@ const (
 	errTemplateTypeInvalidElement             = "template '%s' has type '%s' which never permits '%s' to be set"
 	errDataSourceReadFail                     = "Data Source Read() failure'"
 	errResourceReadFail                       = "Resource Read() failure'"
+
+	docCategorySeparator    = " --- "
+	docCategoryDesign       = "Design" + docCategorySeparator
+	docCategoryResources    = "Resources" + docCategorySeparator
+	docCategoryDatacenter   = "RefDesign: Datacenter" + docCategorySeparator
+	docCategoryFreeform     = "RefDesign: Freeform" + docCategorySeparator
+	docCategoryRefDesignAny = "RefDesign: Any" + docCategorySeparator
+	docCategoryDevices      = "Devices" + docCategorySeparator
 )
diff --git a/apstra/data_source_agent.go b/apstra/data_source_agent.go
@@ -26,7 +26,7 @@ func (o *dataSourceAgent) Configure(ctx context.Context, req datasource.Configur
 
 func (o *dataSourceAgent) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This resource returns details of a Managed Device Agent.",
+		MarkdownDescription: docCategoryDevices + "This resource returns details of a Managed Device Agent.",
 		Attributes:          systemAgents.ManagedDevice{}.DataSourceAttributes(),
 	}
 }

diff --git a/apstra/data_source_agent_profile.go b/apstra/data_source_agent_profile.go
@@ -27,7 +27,7 @@ func (o *dataSourceAgentProfile) Configure(ctx context.Context, req datasource.C
 
 func (o *dataSourceAgentProfile) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source looks up details of an Agent Profile\n\n" +
+		MarkdownDescription: docCategoryDevices + "This data source looks up details of an Agent Profile\n\n" +
 			"At least one optional attribute is required.",
 		Attributes: agentProfile{}.dataSourceAttributes(),
 	}

diff --git a/apstra/data_source_agent_profiles.go b/apstra/data_source_agent_profiles.go
@@ -27,7 +27,7 @@ func (o *dataSourceAgentProfiles) Configure(ctx context.Context, req datasource.
 
 func (o *dataSourceAgentProfiles) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source returns the ID numbers of all Agent Profiles.",
+		MarkdownDescription: docCategoryDevices + "This data source returns the ID numbers of all Agent Profiles.",
 		Attributes: map[string]schema.Attribute{
 			"ids": schema.SetAttribute{
 				MarkdownDescription: "A set of Apstra object ID numbers.",

diff --git a/apstra/data_source_agents.go b/apstra/data_source_agents.go
@@ -29,7 +29,7 @@ func (o *dataSourceAgents) Configure(ctx context.Context, req datasource.Configu
 
 func (o *dataSourceAgents) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source returns the IDs of Managed Device Agents. " +
+		MarkdownDescription: docCategoryDevices + "This data source returns the IDs of Managed Device Agents. " +
 			"All of the `filter` attributes are optional.",
 		Attributes: map[string]schema.Attribute{
 			"ids": schema.SetAttribute{

diff --git a/apstra/data_source_anomalies.go b/apstra/data_source_anomalies.go
@@ -25,7 +25,7 @@ func (o *dataSourceAnomalies) Configure(ctx context.Context, req datasource.Conf
 
 func (o *dataSourceAnomalies) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source provides per-node summary, " +
+		MarkdownDescription: docCategoryRefDesignAny + "This data source provides per-node summary, " +
 			"per-service summary and full details of anomalies in the specified Blueprint.",
 		Attributes: blueprint.Anomalies{}.DataSourceAttributes(),
 	}

diff --git a/apstra/data_source_asn_pool.go b/apstra/data_source_asn_pool.go
@@ -28,7 +28,7 @@ func (o *dataSourceAsnPool) Configure(ctx context.Context, req datasource.Config
 
 func (o *dataSourceAsnPool) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source provides details of a specific ASN Pool.\n\n" +
+		MarkdownDescription: docCategoryResources + "This data source provides details of a specific ASN Pool.\n\n" +
 			"At least one optional attribute is required.",
 		Attributes: resources.AsnPool{}.DataSourceAttributes(),
 	}

diff --git a/apstra/data_source_asn_pools.go b/apstra/data_source_asn_pools.go
@@ -24,7 +24,7 @@ func (o *dataSourceAsnPools) Configure(ctx context.Context, req datasource.Confi
 
 func (o *dataSourceAsnPools) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source returns the ID numbers of all ASN Pools.",
+		MarkdownDescription: docCategoryResources + "This data source returns the ID numbers of all ASN Pools.",
 		Attributes: map[string]schema.Attribute{
 			"ids": schema.SetAttribute{
 				MarkdownDescription: "A set of Apstra object ID numbers.",

diff --git a/apstra/data_source_blueprint_deployment.go b/apstra/data_source_blueprint_deployment.go
@@ -25,7 +25,7 @@ func (o *dataSourceBlueprintDeploy) Configure(ctx context.Context, req datasourc
 
 func (o *dataSourceBlueprintDeploy) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source returns the deployment status of a Blueprint.",
+		MarkdownDescription: docCategoryRefDesignAny + "This data source returns the deployment status of a Blueprint.",
 		Attributes:          blueprint.Deploy{}.DataSourceAttributes(),
 	}
 }

diff --git a/apstra/data_source_blueprint_iba_dashboard.go b/apstra/data_source_blueprint_iba_dashboard.go
@@ -27,7 +27,7 @@ func (o *dataSourceBlueprintIbaDashboard) Configure(ctx context.Context, req dat
 
 func (o *dataSourceBlueprintIbaDashboard) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source provides details of a specific IBA Dashboard in a Blueprint." +
+		MarkdownDescription: docCategoryRefDesignAny + "This data source provides details of a specific IBA Dashboard in a Blueprint." +
 			"\n\n" +
 			"At least one optional attribute is required.",
 		Attributes: iba.Dashboard{}.DataSourceAttributes(),

diff --git a/apstra/data_source_blueprint_iba_dashboards.go b/apstra/data_source_blueprint_iba_dashboards.go
@@ -29,7 +29,7 @@ func (o *dataSourceBlueprintIbaDashboards) Configure(ctx context.Context, req da
 
 func (o *dataSourceBlueprintIbaDashboards) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source returns the ID numbers of all IBA Dashboards in a Blueprint.",
+		MarkdownDescription: docCategoryRefDesignAny + "This data source returns the ID numbers of all IBA Dashboards in a Blueprint.",
 		Attributes: map[string]schema.Attribute{
 			"blueprint_id": schema.StringAttribute{
 				MarkdownDescription: "Apstra Blueprint ID. " +

diff --git a/apstra/data_source_blueprint_iba_predefined_probe.go b/apstra/data_source_blueprint_iba_predefined_probe.go
@@ -27,7 +27,7 @@ func (o *dataSourceBlueprintIbaPredefinedProbe) Configure(ctx context.Context, r
 
 func (o *dataSourceBlueprintIbaPredefinedProbe) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source provides details of a specific IBA Predefined Probe in a Blueprint.",
+		MarkdownDescription: docCategoryRefDesignAny + "This data source provides details of a specific IBA Predefined Probe in a Blueprint.",
 		Attributes:          iba.PredefinedProbe{}.DataSourceAttributes(),
 	}
 }

diff --git a/apstra/data_source_blueprint_iba_widget.go b/apstra/data_source_blueprint_iba_widget.go
@@ -27,7 +27,7 @@ func (o *dataSourceBlueprintIbaWidget) Configure(ctx context.Context, req dataso
 
 func (o *dataSourceBlueprintIbaWidget) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source provides details of a specific IBA Widget in a Blueprint." +
+		MarkdownDescription: docCategoryRefDesignAny + "This data source provides details of a specific IBA Widget in a Blueprint." +
 			"\n\n" +
 			"At least one optional attribute is required.",
 		Attributes: iba.Widget{}.DataSourceAttributes(),

diff --git a/apstra/data_source_blueprints.go b/apstra/data_source_blueprints.go
@@ -35,7 +35,7 @@ func (o *dataSourceBlueprints) Configure(ctx context.Context, req datasource.Con
 
 func (o *dataSourceBlueprints) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source returns the ID numbers of Blueprints.",
+		MarkdownDescription: docCategoryRefDesignAny + "This data source returns the ID numbers of Blueprints.",
 		Attributes: map[string]schema.Attribute{
 			"ids": schema.SetAttribute{
 				MarkdownDescription: "A set of Apstra object ID numbers.",

diff --git a/apstra/data_source_configlet.go b/apstra/data_source_configlet.go
@@ -28,7 +28,7 @@ func (o *dataSourceConfiglet) Configure(ctx context.Context, req datasource.Conf
 
 func (o *dataSourceConfiglet) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source provides details of a specific Configlet.\n\n" +
+		MarkdownDescription: docCategoryDesign + "This data source provides details of a specific Configlet.\n\n" +
 			"At least one optional attribute is required.",
 		Attributes: design.Configlet{}.DataSourceAttributes(),
 	}

diff --git a/apstra/data_source_configlets.go b/apstra/data_source_configlets.go
@@ -29,7 +29,7 @@ func (o *dataSourceConfiglets) Configure(ctx context.Context, req datasource.Con
 
 func (o *dataSourceConfiglets) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source returns the ID numbers of all Configlets.",
+		MarkdownDescription: docCategoryDesign + "This data source returns the ID numbers of all Configlets.",
 		Attributes: map[string]schema.Attribute{
 			"ids": schema.SetAttribute{
 				MarkdownDescription: "A set of Apstra object ID numbers.",

diff --git a/apstra/data_source_datacenter_blueprint.go b/apstra/data_source_datacenter_blueprint.go
@@ -27,7 +27,7 @@ func (o *dataSourceDatacenterBlueprint) Configure(ctx context.Context, req datas
 
 func (o *dataSourceDatacenterBlueprint) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source looks up summary details of a Datacenter Blueprint.\n\n" +
+		MarkdownDescription: docCategoryDatacenter + "This data source looks up summary details of a Datacenter Blueprint.\n\n" +
 			"At least one optional attribute is required.",
 		Attributes: blueprint.Blueprint{}.DataSourceAttributes(),
 	}

diff --git a/apstra/data_source_datacenter_configlet.go b/apstra/data_source_datacenter_configlet.go
@@ -28,7 +28,7 @@ func (o *dataSourceDatacenterConfiglet) Configure(ctx context.Context, req datas
 
 func (o *dataSourceDatacenterConfiglet) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source provides details of a specific Configlet imported into a Blueprint." +
+		MarkdownDescription: docCategoryDatacenter + "This data source provides details of a specific Configlet imported into a Blueprint." +
 			"\n\n" +
 			"At least one optional attribute is required.",
 		Attributes: blueprint.DatacenterConfiglet{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_configlets.go b/apstra/data_source_datacenter_configlets.go
@@ -29,7 +29,7 @@ func (o *dataSourceDatacenterConfiglets) Configure(ctx context.Context, req data
 
 func (o *dataSourceDatacenterConfiglets) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source returns the ID numbers of all Configlets in a Blueprint.",
+		MarkdownDescription: docCategoryDatacenter + "This data source returns the ID numbers of all Configlets in a Blueprint.",
 		Attributes: map[string]schema.Attribute{
 			"blueprint_id": schema.StringAttribute{
 				MarkdownDescription: "Apstra Blueprint ID. Used to identify the Blueprint that the Configlet belongs to.",

diff --git a/apstra/data_source_datacenter_ct_bgp_peering_generic_system.go b/apstra/data_source_datacenter_ct_bgp_peering_generic_system.go
@@ -19,7 +19,7 @@ func (o *dataSourceDatacenterCtBgpPeeringGenericSystem) Metadata(_ context.Conte
 
 func (o *dataSourceDatacenterCtBgpPeeringGenericSystem) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source composes a Connectivity Template Primitive as a JSON string, " +
+		MarkdownDescription: docCategoryDatacenter + "This data source composes a Connectivity Template Primitive as a JSON string, " +
 			"suitable for use in the `primitives` attribute of an `apstra_datacenter_connectivity_template` " +
 			"resource or the `child_primitives` attribute of a Different Connectivity Template Primitive.",
 		Attributes: connectivitytemplate.BgpPeeringGenericSystem{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_ct_bgp_peering_ip_endpoint.go b/apstra/data_source_datacenter_ct_bgp_peering_ip_endpoint.go
@@ -18,7 +18,7 @@ func (o *dataSourceDatacenterCtBgpPeeringIpEndpoint) Metadata(_ context.Context,
 
 func (o *dataSourceDatacenterCtBgpPeeringIpEndpoint) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source composes a Connectivity Template Primitive as a JSON string, " +
+		MarkdownDescription: docCategoryDatacenter + "This data source composes a Connectivity Template Primitive as a JSON string, " +
 			"suitable for use in the `primitives` attribute of an `apstra_datacenter_connectivity_template` " +
 			"resource or the `child_primitives` attribute of a Different Connectivity Template Primitive.",
 		Attributes: connectivitytemplate.BgpPeeringIpEndpoint{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_ct_custom_static_route.go b/apstra/data_source_datacenter_ct_custom_static_route.go
@@ -22,7 +22,7 @@ func (o *dataSourceDatacenterCtCustomStaticRoute) Metadata(_ context.Context, re
 
 func (o *dataSourceDatacenterCtCustomStaticRoute) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source composes a Connectivity Template Primitive as a JSON string, " +
+		MarkdownDescription: docCategoryDatacenter + "This data source composes a Connectivity Template Primitive as a JSON string, " +
 			"suitable for use in the `primitives` attribute of an `apstra_datacenter_connectivity_template` " +
 			"resource or the `child_primitives` attribute of a Different Connectivity Template Primitive.",
 		Attributes: connectivitytemplate.CustomStaticRoute{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_ct_dynamic_bgp_peering.go b/apstra/data_source_datacenter_ct_dynamic_bgp_peering.go
@@ -18,7 +18,7 @@ func (o *dataSourceDatacenterCtDynamicBgpPeering) Metadata(_ context.Context, re
 
 func (o *dataSourceDatacenterCtDynamicBgpPeering) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source composes a Connectivity Template Primitive as a JSON string, " +
+		MarkdownDescription: docCategoryDatacenter + "This data source composes a Connectivity Template Primitive as a JSON string, " +
 			"suitable for use in the `primitives` attribute of an `apstra_datacenter_connectivity_template` " +
 			"resource or the `child_primitives` attribute of a Different Connectivity Template Primitive.",
 		Attributes: connectivitytemplate.DynamicBgpPeering{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_ct_ip_link.go b/apstra/data_source_datacenter_ct_ip_link.go
@@ -18,7 +18,7 @@ func (o *dataSourceDatacenterCtIpLink) Metadata(_ context.Context, req datasourc
 
 func (o *dataSourceDatacenterCtIpLink) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source composes a Connectivity Template Primitive as a JSON string, " +
+		MarkdownDescription: docCategoryDatacenter + "This data source composes a Connectivity Template Primitive as a JSON string, " +
 			"suitable for use in the `primitives` attribute of an `apstra_datacenter_connectivity_template` " +
 			"resource or the `child_primitives` attribute of a Different Connectivity Template Primitive.",
 		Attributes: connectivitytemplate.IpLink{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_ct_routing_policy.go b/apstra/data_source_datacenter_ct_routing_policy.go
@@ -18,7 +18,7 @@ func (o *dataSourceDatacenterCtRoutingPolicy) Metadata(_ context.Context, req da
 
 func (o *dataSourceDatacenterCtRoutingPolicy) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source composes a Connectivity Template Primitive as a JSON string, " +
+		MarkdownDescription: docCategoryDatacenter + "This data source composes a Connectivity Template Primitive as a JSON string, " +
 			"suitable for use in the `primitives` attribute of an `apstra_datacenter_connectivity_template` " +
 			"resource or the `child_primitives` attribute of a Different Connectivity Template Primitive.",
 		Attributes: connectivitytemplate.RoutingPolicy{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_ct_routing_zone_constraint.go b/apstra/data_source_datacenter_ct_routing_zone_constraint.go
@@ -18,7 +18,7 @@ func (o *dataSourceDatacenterCtRoutingZoneConstraint) Metadata(_ context.Context
 
 func (o *dataSourceDatacenterCtRoutingZoneConstraint) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source composes a Connectivity Template Primitive as a JSON string, " +
+		MarkdownDescription: docCategoryDatacenter + "This data source composes a Connectivity Template Primitive as a JSON string, " +
 			"suitable for use in the `primitives` attribute of an `apstra_datacenter_connectivity_template` " +
 			"resource or the `child_primitives` attribute of a Different Connectivity Template Primitive.",
 		Attributes: connectivitytemplate.RoutingZoneConstraint{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_ct_static_route.go b/apstra/data_source_datacenter_ct_static_route.go
@@ -18,7 +18,7 @@ func (o *dataSourceDatacenterCtStaticRoute) Metadata(_ context.Context, req data
 
 func (o *dataSourceDatacenterCtStaticRoute) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source composes a Connectivity Template Primitive as a JSON string, " +
+		MarkdownDescription: docCategoryDatacenter + "This data source composes a Connectivity Template Primitive as a JSON string, " +
 			"suitable for use in the `primitives` attribute of an `apstra_datacenter_connectivity_template` " +
 			"resource or the `child_primitives` attribute of a Different Connectivity Template Primitive.",
 		Attributes: connectivitytemplate.StaticRoute{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_ct_virtual_network_multiple.go b/apstra/data_source_datacenter_ct_virtual_network_multiple.go
@@ -18,7 +18,7 @@ func (o *dataSourceDatacenterCtVnMultiple) Metadata(_ context.Context, req datas
 
 func (o *dataSourceDatacenterCtVnMultiple) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source composes a Connectivity Template Primitive as a JSON string, " +
+		MarkdownDescription: docCategoryDatacenter + "This data source composes a Connectivity Template Primitive as a JSON string, " +
 			"suitable for use in the `primitives` attribute of an `apstra_datacenter_connectivity_template` " +
 			"resource or the `child_primitives` attribute of a Different Connectivity Template Primitive.",
 		Attributes: connectivitytemplate.VnMultiple{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_ct_virtual_network_single.go b/apstra/data_source_datacenter_ct_virtual_network_single.go
@@ -18,7 +18,7 @@ func (o *dataSourceDatacenterCtVnSingle) Metadata(_ context.Context, req datasou
 
 func (o *dataSourceDatacenterCtVnSingle) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source composes a Connectivity Template Primitive as a JSON string, " +
+		MarkdownDescription: docCategoryDatacenter + "This data source composes a Connectivity Template Primitive as a JSON string, " +
 			"suitable for use in the `primitives` attribute of an `apstra_datacenter_connectivity_template` " +
 			"resource or the `child_primitives` attribute of a Different Connectivity Template Primitive.",
 		Attributes: connectivitytemplate.VnSingle{}.DataSourceAttributes(),

diff --git a/apstra/data_source_datacenter_interfaces_by_link_tag.go b/apstra/data_source_datacenter_interfaces_by_link_tag.go
@@ -27,7 +27,7 @@ func (o *dataSourceInterfacesByLinkTag) Configure(ctx context.Context, req datas
 
 func (o *dataSourceInterfacesByLinkTag) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source returns the IDs of Interfaces by Link Tag.",
+		MarkdownDescription: docCategoryDatacenter + "This data source returns the IDs of Interfaces by Link Tag.",
 		Attributes:          blueprint.InterfacesByLinkTag{}.DataSourceAttributes(),
 	}
 }

diff --git a/apstra/data_source_datacenter_interfaces_by_system.go b/apstra/data_source_datacenter_interfaces_by_system.go
@@ -27,7 +27,7 @@ func (o *dataSourceInterfacesBySystem) Configure(ctx context.Context, req dataso
 
 func (o *dataSourceInterfacesBySystem) Schema(_ context.Context, _ datasource.SchemaRequest, resp *datasource.SchemaResponse) {
 	resp.Schema = schema.Schema{
-		MarkdownDescription: "This data source returns a map of Interface IDs keyed by Interface Name for the given System ID.",
+		MarkdownDescription: docCategoryDatacenter + "This data source returns a map of Interface IDs keyed by Interface Name for the given System ID.",
 		Attributes:          blueprint.InterfacesBySystem{}.DataSourceAttributes(),
 	}
 }