Re: [RFC 1/8] docs: networking: reorganize driver documentation again
From: Jakub Kicinski <kuba@kernel.org>
Date: 2020-06-11 23:09:16
Also in:
linux-doc
From: Jakub Kicinski <kuba@kernel.org>
Date: 2020-06-11 23:09:16
Also in:
linux-doc
On Thu, 11 Jun 2020 15:18:42 -0700 Stephen Hemminger wrote:
quoted
quoted
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.