Documentation pages needing updates

Talk about Documentation
1

Hi all, I would like to point out and propose some changes to the openwrt documentation found on the wiki.

  1. DSA and the general networking page need updating. For example, https://openwrt.org/docs/guide-user/network/network_configuration uses vlan alias style port specification and not DSA format nor is there a DSA example on the page (the page links to https://openwrt.org/docs/guide-user/network/dsa/start)

  2. 802.11r, 11k & 11v - configuration information is hard to follow on https://openwrt.org/docs/guide-user/network/wifi/basic & the various forum posts found here can often be somewhat confusing about what is and what isn't required

  3. Device specific configuration/best practice suggestions - in general this is missing & possibly something that updating/changing default installation packages & configs may at least part address.
    Some examples include - packet steering configuration & if manual irq configuration should be used or if irqbalance should be used

Related to 2 - are there any defaults that should be looked into being changed - e.g. wnm sleep mode ?

1 Like
2

You used to be able to create a mockup page with a wiki account, if it's still an option, maybe you should go ahead and create new pages with the changes you want to implement to solicit better feedback.

Also tagging @thess as I'm not sure who is currently the wiki maintainer. @d1b maybe check the wiki history and discuss the changes with the last author.

1 Like
3

Sounds good re mock ups / proposed pages/changes.