# Re: \[RFC 1/8\] docs: networking: reorganize driver documentation again

- From: Jakub Kicinski \<kuba@kernel.org\>
- Date: 2020-06-11 23:09:16 
- List: netdev
- Page: https://ratatoskr.run/netdev/2020/06/8524371
- Thread: https://ratatoskr.run/netdev/2020/06/8524359/t.md

```text
On Thu, 11 Jun 2020 15:18:42 -0700 Stephen Hemminger wrote:
> > > Organize driver documentation by device type. Most documents
> > > have fairly verbose yet uninformative names, so let users
> > > first select a well defined device type, and then search for
> > > a particular driver.
> > > 
> > > While at it rename the section from Vendor drivers to
> > > Hardware drivers. This seems more accurate, besides people
> > > sometimes refer to out-of-tree drivers as vendor drivers.
> > > 
> > > Signed-off-by: Jakub Kicinski <kuba@kernel.org>  
> 
> How much of it is still relevant and useful?
> 
> The last time I checked, lots of this had bad advice about settings.
> And there was lots of drivers documenting what was generic Linux
> functionality
> 
> And still there were references to old commands like ifconfig or ifenslave.

For general documentation I hope now that it's slightly de-cluttered
it's more likely folks (including myself, time allowing) will be more
inclined to clean up / contribute. I haven't looked in detail, yet.

As for the vendor docs - I guess that the obsolescence of the docs/
instructions goes hand in hand with obsolescence of the HW itself.
```
