@ANS-TF-BMS: Overhaul the BMS guide and update the examples throughout the resource documentation.

Significantly expand docs/guides/baremetal_server_management.md with a resources/data-sources reference table, a comprehensive Known Limitations section (platform, firewall, and group constraints), and a restructured workflow overview.
Fix BMS group examples in policy_security_policy, policy_parent_security_policy, and policy_security_policy_rule docs to include the required group_type = "BareMetalServer" attribute.
Remove unsupported mixed
BMS/VM policy examples that incorrectly implied cross-type grouping. Apply minor wording and formatting corrections across all BMS data-source and resource doc pages.

Testing Environment:

NSX-T Version: 9.0.0+
Provider Version: >=3.12.1
Infrastructure: Local Manager only (Federation and Multi-tenancy not supported for BMS)

JIRA: #NSEC-14099

Author: ps031046

docs/data-sources/policy_baremetal_server.md

@@ -1,6 +1,6 @@
 ---
 subcategory: "Beta"
-page_title: "NSXT: policy_baremetal_server"
+page_title: "NSXT: nsxt_policy_baremetal_server"
 description: A bare metal server inventory data source.
 ---
 
@@ -50,6 +50,7 @@ output "server_os" {
 In addition to arguments listed above, the following attributes are exported:
 
 * `id` - ID of the data source.
+* `display_name` - Display name of the bare metal server.
 * `source_id` - Source ID of the bare metal server.
 * `cpu_cores` - Number of CPU cores.
 * `os_name` - Operating system name.

docs/data-sources/policy_baremetal_server_group_associations.md

@@ -1,6 +1,6 @@
 ---
 subcategory: "Beta"
-page_title: "NSXT: policy_baremetal_server_group_associations"
+page_title: "NSXT: nsxt_policy_baremetal_server_group_associations"
 description: Groups a bare metal server is a member of.
 ---
 
@@ -41,6 +41,7 @@ resource "nsxt_policy_service" "https" {
 resource "nsxt_policy_group" "web-servers" {
   display_name = "Web-Servers-Group"
   description  = "Group containing web server bare metal resources"
+  group_type   = "BareMetalServer"
 
   criteria {
     condition {

docs/data-sources/policy_baremetal_server_interface.md

@@ -1,6 +1,6 @@
 ---
 subcategory: "Beta"
-page_title: "NSXT: policy_baremetal_server_interface"
+page_title: "NSXT: nsxt_policy_baremetal_server_interface"
 description: A bare metal server interface inventory data source.
 ---
 
@@ -50,6 +50,7 @@ output "interface_ips" {
 In addition to arguments listed above, the following attributes are exported:
 
 * `id` - ID of the data source.
+* `display_name` - Display name of the bare metal server interface.
 * `bms_external_id` - External ID of the parent bare metal server.
 * `source_id` - Source ID of the bare metal server interface.
 * `is_mgmt_interface` - Whether this is a management interface.

docs/data-sources/policy_baremetal_server_interface_group_associations.md

@@ -1,6 +1,6 @@
 ---
 subcategory: "Beta"
-page_title: "NSXT: policy_baremetal_server_interface_group_associations"
+page_title: "NSXT: nsxt_policy_baremetal_server_interface_group_associations"
 description: Groups a bare metal server interface is a member of.
 ---
 
@@ -22,6 +22,7 @@ data "nsxt_policy_baremetal_server_interface_group_associations" "if1_groups" {
 resource "nsxt_policy_group" "data-network" {
   display_name = "Data-Network-Group"
   description  = "Group containing data network interfaces"
+  group_type   = "BareMetalServer"
 
   criteria {
     condition {

docs/data-sources/policy_baremetal_server_interface_tags.md

@@ -1,6 +1,6 @@
 ---
 subcategory: "Beta"
-page_title: "NSXT: policy_baremetal_server_interface_tags"
+page_title: "NSXT: nsxt_policy_baremetal_server_interface_tags"
 description: A Bare Metal Server Interface Tags data source.
 ---
 
@@ -44,6 +44,7 @@ resource "nsxt_policy_group" "data_plane_interfaces" {
   count = local.network_type == "data-plane" ? 1 : 0
 
   display_name = "Data-Plane-Interfaces"
+  group_type   = "BareMetalServer"
 
   criteria {
     condition {

docs/data-sources/policy_baremetal_server_interfaces.md

@@ -1,6 +1,6 @@
 ---
 subcategory: "Beta"
-page_title: "NSXT: policy_baremetal_server_interfaces"
+page_title: "NSXT: nsxt_policy_baremetal_server_interfaces"
 description: List of bare metal server interfaces in NSX inventory with advanced filtering.
 ---
 

docs/data-sources/policy_baremetal_server_tags.md

@@ -1,6 +1,6 @@
 ---
 subcategory: "Beta"
-page_title: "NSXT: policy_baremetal_server_tags"
+page_title: "NSXT: nsxt_policy_baremetal_server_tags"
 description: A Bare Metal Server Tags data source.
 ---
 

docs/data-sources/policy_baremetal_servers.md

@@ -1,6 +1,6 @@
 ---
 subcategory: "Beta"
-page_title: "NSXT: policy_baremetal_servers"
+page_title: "NSXT: nsxt_policy_baremetal_servers"
 description: List of bare metal servers discovered by NSX with advanced filtering.
 ---
 

docs/data-sources/policy_group_baremetal_server_interface_members.md

@@ -1,6 +1,6 @@
 ---
 subcategory: "Beta"
-page_title: "NSXT: policy_group_baremetal_server_interface_members"
+page_title: "NSXT: nsxt_policy_group_baremetal_server_interface_members"
 description: A policy data source to list bare metal server interface members in a group.
 ---
 

docs/data-sources/policy_group_baremetal_server_members.md

@@ -1,6 +1,6 @@
 ---
 subcategory: "Beta"
-page_title: "NSXT: policy_group_baremetal_server_members"
+page_title: "NSXT: nsxt_policy_group_baremetal_server_members"
 description: A policy data source to list bare metal server members in a group.
 ---