mbox series

[v2,0/9] Improve Linux drivers GSG section

Message ID 20220316134551.1099599-1-bruce.richardson@intel.com (mailing list archive)
Headers
Series Improve Linux drivers GSG section |

Message

Bruce Richardson March 16, 2022, 1:45 p.m. UTC
  This patchset reworks large parts of the linux drivers section of the
Linux Getting Started Guide, so as to make it clearer and easier to
read. The overall flow of the page is adjusted so that more important
information is nearer the top, and so that all information on VFIO is
consolidated into a single section. In terms of the content of the
sections, there are some minor changes to adjust what is a warning vs
just a "note" in the doc, and there are some updates to increase
emphasis on VFIO ovs UIO.

Including stable on CC for the set, as all patches may be candidates for
backport to help improve docs for older releases too.

V2:
* Rebased on top of main, now that other doc patches are applied
* Reworded commit titles to use "doc:" prefix

Bruce Richardson (9):
  doc: replace special characters for (R) symbol in Linux GSG
  doc: fix missing note on UIO module in Linux GSG
  doc: make UIO safety warning more visible in Linux GSG
  doc: move section on binding drivers up the page in GSG
  doc: emphasise VFIO over UIO-based modules in GSG
  doc: split GSG VFIO section into subsections
  doc: move GSG section on UIO to the end of drivers page
  doc: consolidate all VFIO content on GSG driver page
  doc: change informational warnings to notes in Linux GSG

 doc/guides/linux_gsg/enable_func.rst   |   8 +-
 doc/guides/linux_gsg/linux_drivers.rst | 396 +++++++++++++------------
 doc/guides/linux_gsg/sys_reqs.rst      |   6 +-
 3 files changed, 217 insertions(+), 193 deletions(-)

--
2.32.0
  

Comments

Thomas Monjalon March 16, 2022, 5:41 p.m. UTC | #1
16/03/2022 14:45, Bruce Richardson:
> This patchset reworks large parts of the linux drivers section of the
> Linux Getting Started Guide, so as to make it clearer and easier to
> read. The overall flow of the page is adjusted so that more important
> information is nearer the top, and so that all information on VFIO is
> consolidated into a single section. In terms of the content of the
> sections, there are some minor changes to adjust what is a warning vs
> just a "note" in the doc, and there are some updates to increase
> emphasis on VFIO ovs UIO.
> 
> Including stable on CC for the set, as all patches may be candidates for
> backport to help improve docs for older releases too.
> 
> V2:
> * Rebased on top of main, now that other doc patches are applied
> * Reworded commit titles to use "doc:" prefix
> 
> Bruce Richardson (9):
>   doc: replace special characters for (R) symbol in Linux GSG
>   doc: fix missing note on UIO module in Linux GSG
>   doc: make UIO safety warning more visible in Linux GSG
>   doc: move section on binding drivers up the page in GSG
>   doc: emphasise VFIO over UIO-based modules in GSG
>   doc: split GSG VFIO section into subsections
>   doc: move GSG section on UIO to the end of drivers page
>   doc: consolidate all VFIO content on GSG driver page
>   doc: change informational warnings to notes in Linux GSG

Except for the first 2 patches, I think it is not mandatory to backport,
so I've removed the tag Cc:stable.

Applied, thanks.