-- 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 <ha...@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ç
_______________________________________________
openwrt-devel mailing list
openwrt-devel@lists.openwrt.org
https://lists.openwrt.org/mailman/listinfo/openwrt-devel
