|
|
Log in / Subscribe / Register

docs: net: updates for old and cobwebbed docs

From:  Jakub Kicinski <kuba-AT-kernel.org>
To:  davem-AT-davemloft.net
Subject:  [PATCH net-next 00/10] docs: net: updates for old and cobwebbed docs
Date:  Tue, 26 May 2026 09:01:41 -0700
Message-ID:  <20260526160151.2793354-1-kuba@kernel.org>
Cc:  netdev-AT-vger.kernel.org, edumazet-AT-google.com, pabeni-AT-redhat.com, andrew+netdev-AT-lunn.ch, horms-AT-kernel.org, corbet-AT-lwn.net, vladimir.oltean-AT-nxp.com, willemb-AT-google.com, sdf.kernel-AT-gmail.com, ecree.xilinx-AT-gmail.com, jesse.brandeburg-AT-intel.com, linux-doc-AT-vger.kernel.org, Jakub Kicinski <kuba-AT-kernel.org>
Archive-link:  Article

I'm hoping to start feeding our docs into the AI review tools, instead
of maintaining a separate repo with review prompts. To experiment with
that we have to refresh the docs a little bit.

A read thru our current docs makes one slightly question the value
of including them in reviews. But directionally, I feel, it's probably
still right. I'm hoping the Rx Checksum section about not dropping packets
for example to be impactful. I don't think the current AI agents or
review docs include this guidance.

Jakub Kicinski (10):
  docs: net: netdevices: small fixes and clarifications
  docs: net: fix minor issues with driver guide
  docs: net: statistics: fix kernel-internal stats list
  docs: net: update devmem code examples
  docs: net: fix minor issues with the NAPI guide
  docs: net: refresh netdev feature guidance
  docs: net: fix minor issues with checksum offloads
  docs: net: add Rx notes to the checksum guide
  docs: net: render the checksum comment in checksum-offloads.rst
  docs: net: fix minor issues with segmentation offloads

 .../networking/checksum-offloads.rst          | 67 ++++++++++++-------
 Documentation/networking/devmem.rst           | 27 +++-----
 Documentation/networking/driver.rst           |  7 +-
 Documentation/networking/napi.rst             | 11 ++-
 Documentation/networking/netdev-features.rst  | 60 +++++++++++------
 Documentation/networking/netdevices.rst       | 31 +++++----
 .../networking/segmentation-offloads.rst      | 37 +++++++++-
 Documentation/networking/skbuff.rst           |  6 --
 Documentation/networking/statistics.rst       | 19 ++++--
 9 files changed, 172 insertions(+), 93 deletions(-)

-- 
2.54.0



Copyright © 2026, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds