Re: [PATCH pve-docs v2 1/1] network/sdn: update and clean up VLAN information

[Stefan Hanreich <s.hanreich@proxmox.com>]

On 10/21/26 9:28 AM, Thomas Ellmenreich wrote:
> On Tue Oct 20, 2026 at 3:54 PM CEST, Stefan Hanreich wrote:
>> On 10/20/26 8:45 AM, Thomas Ellmenreich wrote:
> 
> [snip]
> 
>>> +[[vlan_common_issues]]
>>> +Common Issues
>>> +^^^^^^^^^^^^^
>>> +
>>> +.Issue: Configuring VLAN on interface that is member of bridge
>>> +
>>> +It's not recommended to configure a VLAN on an interface that is a member of a
>>> +bridge. Doing so will "blackhole" all traffic of that VLAN on the bridge.
>>
>> Might need a more specific example so this becomes clearer? It's hard to understand
>> otherwise imo.
> 
> If I understand correctly, the example [0] you mention further down would be
> an instance of 'blackholing' the traffic. Perhaps I could mention that
> example here instead of creating a separate point for it.
> 
> Is this assumption correct?

Yes, although I'm unsure if we should include the concrete examples for the issues,
as it is easy for people to copy-paste them accidentally when not paying attention.

Maybe it'd make more sense to skip the "Configuring VLAN on interface that is member
of bridge" issue altogether as it is rather generic and doesn't really say much and
not an issue per-se. It's imo better to have the concrete failure scenarios in this
section and then tell users how they would identify / rectify it.

e.g. "GW gets lost after reboot" -> "Check if GW is configured on VLAN-aware bridge"