"don't use ifconfig, use ip instead"
"don't use iptables, is nftables instead"
"don't use brctl, use bridge command instead"
"don't use the route command, use ip instead"
That's cool, but is there any documentation other than a man page for any of these ? The number of blog and forum posts for using brctl are multiple orders of magnitude greater than using bridge. And worse bridge as a command is utterly shit to Google for.
Documentation of Linux has gone down hill a lot in recent years.
If you want to do anything with any complexity then the documentation just isn't there. And it's really starting to piss me off. What's worse is I'm feeling really bitten by open source projects right now and not feeling particularly welcome for contributing anything. I spent 3 days trying to work out how to get one line deleted from a linux device driver, to fix a bug. I gave up because I couldn't work who to even talk to, let alone how to start the conversation.
And by complexity. I have machines with multi hundred line nftables configs for ipv4 and ipv6 and bridging and vlans. All crafted by hand. All documented with comments. Hell my firewall config has more comments than some of the source code I've come across lately... It's a fight to find any information to make this function. It's 2 years of work.