I am willing to spend the time to rewrite the vlan page to make it friendly to those with little networking knowledge. Currently it has lots of technical information which is good for someone who knows what they are doing but is it overwhelming to people who may not have a lot of experience. I think walls of text can be off putting and it would be better to screamline it with images, diagrams and text formatting.
I think it would be best to have two vlan pages. One page would be for new users while the other would be for developers. My thought is that the user guide page could focus on explaining vlans and how they work in Linux and OpenWRT. The advanced page could have all the technical stuff for those going into the weeds. The current page could simply be moved to for developers and a new page could be created for beginners.