[ovs-dev] [PATCH v3 0/9] Split up the DPDK how-to

Stephen Finucane stephen at that.guru
Thu Apr 19 12:57:20 UTC 2018

The DPDK howto has slowly morphed into a catch all for everything DPDK,
which goes against the original design goal for 'howto' documents [*].
This series attempts to return some sanity to the universe by splitting
this document into many more 'topic' documents. Along the way, we add a
lot of semantic markup, rework some text, and add an overview on
'dpdk'-type ports (the original goal here).

There's a good chance I've made some mistakes in the process and I've
left TODOs for someone to resolve now or at a future date. I welcome
feedback on both of these.

[*] 'howto' documents are supposed to be brief, high-level overviews on
    a particular group of features, with a focus on the user. They're
    not as all-encompassing as a 'tutorial', but not as specific as a

Changes since v2:
- Addressed comments from Ian Stokes

Stephen Finucane (9):
  doc: Add an overview of the 'dpdk' port
  doc: Add "PMD" topic document
  doc: Move additional sections to "physical ports" doc
  doc: Add "vdev" topic document
  doc: Move "QoS" guide to its own document
  doc: Add "bridge" topic document
  doc: Move "pdump" guide to its own document
  doc: Add "jumbo frames" topic document
  doc: Final cleanup of the DPDK documents

 Documentation/automake.mk                  |   7 +
 Documentation/conf.py                      |   2 +-
 Documentation/howto/dpdk.rst               | 454 +++--------------------------
 Documentation/topics/dpdk/bridge.rst       | 104 +++++++
 Documentation/topics/dpdk/index.rst        |  20 +-
 Documentation/topics/dpdk/jumbo-frames.rst |  73 +++++
 Documentation/topics/dpdk/pdump.rst        |  67 +++++
 Documentation/topics/dpdk/phy.rst          | 226 ++++++++++++++
 Documentation/topics/dpdk/pmd.rst          | 161 ++++++++++
 Documentation/topics/dpdk/qos.rst          |  78 +++++
 Documentation/topics/dpdk/ring.rst         |   5 +
 Documentation/topics/dpdk/vdev.rst         |  66 +++++
 Documentation/topics/dpdk/vhost-user.rst   |  28 +-
 13 files changed, 863 insertions(+), 428 deletions(-)
 create mode 100644 Documentation/topics/dpdk/bridge.rst
 create mode 100644 Documentation/topics/dpdk/jumbo-frames.rst
 create mode 100644 Documentation/topics/dpdk/pdump.rst
 create mode 100644 Documentation/topics/dpdk/phy.rst
 create mode 100644 Documentation/topics/dpdk/pmd.rst
 create mode 100644 Documentation/topics/dpdk/qos.rst
 create mode 100644 Documentation/topics/dpdk/vdev.rst


More information about the dev mailing list