From 10b1e41fb6c6e6879186d0b0b7077ac64472c6fd Mon Sep 17 00:00:00 2001
From: Pavel Boldyrev <627562+bpg@users.noreply.github.com>
Date: Mon, 16 Sep 2024 18:19:54 -0400
Subject: [PATCH] chore(docs): improve `network_linux_bridge` documentation

Signed-off-by: Pavel Boldyrev <627562+bpg@users.noreply.github.com>
---
 .../virtual_environment_network_linux_bridge.md     | 13 +++++++++++++
 .../resource.tf                                     | 13 +++++++++++++
 2 files changed, 26 insertions(+)

diff --git a/docs/resources/virtual_environment_network_linux_bridge.md b/docs/resources/virtual_environment_network_linux_bridge.md
index 5826ae670..064a11fc1 100644
--- a/docs/resources/virtual_environment_network_linux_bridge.md
+++ b/docs/resources/virtual_environment_network_linux_bridge.md
@@ -27,9 +27,22 @@ resource "proxmox_virtual_environment_network_linux_bridge" "vmbr99" {
   comment = "vmbr99 comment"
 
   ports = [
+    # Network (or VLAN) interfaces to attach to the bridge, specified by their interface name
+    # (e.g. "ens18.99" for VLAN 99 on interface ens18).
+    # For VLAN interfaces with custom names, use the interface name without the VLAN tag, e.g. "vlan_lab"
     "ens18.99"
   ]
 }
+
+resource "proxmox_virtual_environment_network_linux_vlan" "vlan99" {
+  node_name = "pve"
+  name      = "ens18.99"
+
+  ## or alternatively, use custom name:
+  # name      = "vlan_lab"
+  # interface = "eno0"
+  # vlan      = 98
+}
 ```
 
 <!-- schema generated by tfplugindocs -->
diff --git a/examples/resources/proxmox_virtual_environment_network_linux_bridge/resource.tf b/examples/resources/proxmox_virtual_environment_network_linux_bridge/resource.tf
index 9b10607e9..6d85d49e6 100644
--- a/examples/resources/proxmox_virtual_environment_network_linux_bridge/resource.tf
+++ b/examples/resources/proxmox_virtual_environment_network_linux_bridge/resource.tf
@@ -11,6 +11,19 @@ resource "proxmox_virtual_environment_network_linux_bridge" "vmbr99" {
   comment = "vmbr99 comment"
 
   ports = [
+    # Network (or VLAN) interfaces to attach to the bridge, specified by their interface name
+    # (e.g. "ens18.99" for VLAN 99 on interface ens18).
+    # For VLAN interfaces with custom names, use the interface name without the VLAN tag, e.g. "vlan_lab"
     "ens18.99"
   ]
 }
+
+resource "proxmox_virtual_environment_network_linux_vlan" "vlan99" {
+  node_name = "pve"
+  name      = "ens18.99"
+
+  ## or alternatively, use custom name:
+  # name      = "vlan_lab"
+  # interface = "eno0"
+  # vlan      = 98
+}