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

From
Stephen Hemminger <stephen@networkplumber.org>
Date
2020-06-11 22:18:55
Also in
linux-doc
Reply to
Kirsher, Jeffrey T, 2020-06-11
On Thu, 11 Jun 2020 21:17:49 +0000
"Kirsher, Jeffrey T" [off-list ref] wrote:
quoted
-----Original Message-----
From: Jakub Kicinski <kuba@kernel.org>
Sent: Thursday, June 11, 2020 10:30
To: davem@davemloft.net
Cc: <redacted>; <redacted>; Jakub Kicinski
[off-list ref]; klassert@kernel.org; akiyano@amazon.com;
irusskikh@marvell.com; ioana.ciornei@nxp.com; kys@microsoft.com;
saeedm@mellanox.com; jdmason@kudzu.us; snelson@pensando.io; GR-Linux-
NIC-Dev@marvell.com; stuyoder@gmail.com; Kirsher, Jeffrey T
[off-list ref]; sgoutham@marvell.com; luobin9@huawei.com;
csully@google.com; kou.ishizaki@toshiba.co.jp; peppe.cavallaro@st.com;
chessman@tux.org
Subject: [RFC 1/8] docs: networking: reorganize driver documentation again

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.
Thread (15 messages) 15 messages, 4 authors, last reply 2020-06-12
Keyboard shortcuts
hback out one level
jnext message in thread / next series-diff position
kprevious message in thread / previous series-diff position
ldrill in
Escclose help / fold thread tree
?toggle this help