OpenWrt 21.02.0 Fourth release candidate - DSA docs

[Arınç ÜNAL]

-- What this mail is trying to accomplish?

Change "interface" and "device" networking terms on LuCI/UCI and OpenWrt 
Wiki.

-- Device and Interface Confusion

With DSA, each switch port became an interface, and that produced the 
need of configuring interfaces. This confusion became more prevalent 
after mid-2020, when the ability of creating interfaces & using bridge 
VLAN filter feature of the Linux kernel using UCI/LuCI was implemented 
on OpenWrt.

The current naming used on LuCI/UCI is inaccurate and confusing. The 
“interfaces” under Network → Interfaces actually represent networks. The 
actual interfaces are called “device”.

UCI treats “config interface” as configuring networks but “config 
device” as configuring interfaces.
If one heads to Network → Wireless and assign a wireless interface to a 
network, LuCI literally calls the networks under Network → Interfaces as 
“Network”.

Therefore I propose these changes to LuCI & UCI:

-- UCI Syntax

- config interface -> config network
- config device -> config interface

-- LuCI

- Rename "Interfaces" on the section tab and the heading to "Networks"
- Rename "Devices" to "Interfaces"

---

About the DSA documentation... I believe DSA & Bridge VLAN filtering 
feature should be properly distinguished on the wiki to prevent 
confusion. I'll work on this along with other things on the 
documentation with Rich.

Cheers.
Arınç

On 22/08/2021 18:15, Arınç ÜNAL wrote:
> Hello. (This is my new email address that I use from now on. I'm also 
> testing a new mail client, sorry if my reply is unintentionally garbled.)
> 
> On 22/08/2021 17:11, Rich Brown wrote:
>> All,
>>
>>> On Aug 10, 2021, at 1:10 PM, Hauke Mehrtens <hauke at hauke-m.de> wrote:
>>>
>>> ... For 21.02 we should work on the DSA documentation which Rafal and 
>>> Rich already did and continue like it is now...
>> Maybe I'm worrying needlessly, but I want to say I'm concerned about 
>> those DSA pages on the wiki.
>>
>> They may look polished, but there are open (unanswered) questions in 
>> the text. I suspect they're WRONG in many places. I do not know enough 
>> to make any further changes to the documents:
>>
>> DSA Mini-Tutorial: 
>> https://openwrt.org/docs/guide-user/network/dsa/dsa-mini-tutorial
>>
>> Converting to DSA: 
>> https://openwrt.org/docs/guide-user/network/dsa/converting-to-dsa
>>
>> Upgrading to OpenWrt 21.02.0: 
>> https://openwrt.org/docs/guide-user/network/dsa/upgrading-to-2102
>>
>> Is anyone willing to assure me that these are "good enough" for a 
>> release? If not, how shall we get these pages "up to snuff?" Thanks.
> 
> "Upgrading to OpenWrt 21.02.0" looks inclusive enough in my humble opinion.
> 
> However, I think that the DSA Mini-Tutorial & Converting to DSA pages 
> are absolutely not good enough for a release.
> 
> I've got a lot of points to make, so I'm going to write another email 
> about it in the upcoming days.
> 
> Arınç
>