[pve-devel] [PATCH pve-docs 1/1] fabrics: add initial documentation for sdn fabrics

[Christoph Heiss]

On Wed Apr 2, 2025 at 11:09 AM CEST, Gabriel Goller wrote:
[..]
>>> +Interfaces:: Specify the interfaces used to establish peering connections with
>>> +other OpenFabric nodes. Preferably select interfaces without pre-assigned IP
>>> +addresses, then configure addresses in the IPv4/IPv6 column if needed. A dummy
>>> +"loopback" interface with the router-id is automatically created.
>>> +Interface-specific settings override the global fabric settings.
>>> +
>>> +The following optional parameters can be configured per interface when enabling
>>> +the additional columns:
>>
>>Perhaps this sentence should be made a bit more prominent, e.g. as
>>sub-heading? It's easy to read over it and miss it, but it's quite
>>important piece of information. Especially if your not *that* familiar
>>with the UI and enablable columns.
>>
>>There are advanced options, so hiding them by default is good IMO - just
>>a bit confusing to have big headings with the option names but nowhere
>>to enable them (directly).
>
> I thought about adding section (even though this is not exactly a
> different panel in the UI), e.g.,
>
>      On The Interface
>      ^^^^^^^^^^^^^^^^
>
> So we'd have:
> OpenFabric
>   - On the Node
>   - On the Interface
>   - On the Fabric
>
> and obviously the same with OSPF.
>
> What do you think?

Yeah, sounds good to me! Makes it clear(er) what settings belong to what
part of the fabric and hopefully avoid confusion as to where to
configure each setting exactly.