Lukas Märdian <sl...@debian.org> writes: > On 04.09.24 17:26, Marco d'Itri wrote: >> Do we even have general documentation about configuring networking? > > Yes, there is a "NetworkConfiguration" page on the wiki and the Debian ref: > > * https://wiki.debian.org/NetworkConfiguration
I dont thinj this page is usefulnfor most users. It starts with "Reader Prerequisites: To get the most from this article, understand the following concepts before reading: basic unix command line tools, text editors, DNS, TCP/IP, DHCP, netmask, gateway"" It does not mention wifi at all?? > * https://www.debian.org/doc/manuals/debian-reference/ch05.en.html This seems to be a half-finished draft? it starts with no context, then a seemingly random list of packages, "the basic network infrastructure on the modern Debian system" most of which are not installed by default. > Together, they show something like 5+ ways of how to do things: > > * /etc/network/interfaces > * iproute2 > * Netplan > * NetworkManager > * systemd-networkd > > Which one to choose? Well it all depends on the underlying stack, which > the average user might not necessarily know. So it's very confusing. i dont see how netplan helps here --- the pages are confusing because they are poorly written, not aimed at end users of modern networking, and have non-idiomatic english -- this is not a criticism of anyone, im sure this was useful in the 1990s when you had to "configure the network", but things have moved on - and just work for all but advanced users. I think these documents should be archived (or completely rewritten). New users dont need these documents, they just need to know how to enter their wifi details More advanced users probably need several documents, depending on what they want to do. Eg, how to run private networks for containers, how to change dns servers, how to configure a firewall, how to turn your laptop into a router, how to use ipv6 etc. Does netplan make that easier?
