# Documentation pages needing updates

**URL:** <https://forum.openwrt.org/t/documentation-pages-needing-updates/176682>\
**Category:** Talk about Documentation\
**Created:** [November 6, 2023, 3:20am UTC](https://forum.openwrt.org/t/documentation-pages-needing-updates/176682 "2023-11-06T03:20:35Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![d1b](https://forum.openwrt.org/user_avatar/forum.openwrt.org/d1b/32/3368_2.png) [@d1b](https://forum.openwrt.org/u/d1b)\
**Post date:** [November 6, 2023, 3:20am UTC](https://forum.openwrt.org/t/documentation-pages-needing-updates/176682/1 "2023-11-06T03:20:35Z")

</div>

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](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](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](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 ?

---

<div class="post-metadata">

**Author:** ![stangri](https://forum.openwrt.org/user_avatar/forum.openwrt.org/stangri/32/58_2.png) [@stangri](https://forum.openwrt.org/u/stangri)\
**Post date:** [November 6, 2023, 3:44am UTC](https://forum.openwrt.org/t/documentation-pages-needing-updates/176682/2 "2023-11-06T03:44:37Z")

</div>

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.

---

<div class="post-metadata">

**Author:** ![d1b](https://forum.openwrt.org/user_avatar/forum.openwrt.org/d1b/32/3368_2.png) [@d1b](https://forum.openwrt.org/u/d1b)\
**Post date:** [November 6, 2023, 4:00am UTC](https://forum.openwrt.org/t/documentation-pages-needing-updates/176682/3 "2023-11-06T04:00:22Z")

</div>

Sounds good re mock ups / proposed pages/changes.