From 2eaf6a08559ac915da9e060ce0251ccfa9d97fcd Mon Sep 17 00:00:00 2001 From: Stephen Finucane Date: Thu, 22 Dec 2016 09:54:45 +0000 Subject: doc: Add a 'what-is-ovs' document Add description of Open vSwitch from README, along with the overview image from openvswitch.org. Signed-off-by: Stephen Finucane Signed-off-by: Ben Pfaff --- Documentation/_static/overview.png | Bin 0 -> 203079 bytes Documentation/automake.mk | 2 ++ Documentation/index.rst | 3 +++ Documentation/intro/index.rst | 1 + Documentation/intro/what-is-ovs.rst | 41 ++++++++++++++++++++++++++++++++++++ 5 files changed, 47 insertions(+) create mode 100644 Documentation/_static/overview.png create mode 100644 Documentation/intro/what-is-ovs.rst (limited to 'Documentation') diff --git a/Documentation/_static/overview.png b/Documentation/_static/overview.png new file mode 100644 index 000000000..68948cf21 Binary files /dev/null and b/Documentation/_static/overview.png differ diff --git a/Documentation/automake.mk b/Documentation/automake.mk index b7b3cc1fa..98adca74d 100644 --- a/Documentation/automake.mk +++ b/Documentation/automake.mk @@ -1,10 +1,12 @@ EXTRA_DIST += \ Documentation/group-selection-method-property.txt \ Documentation/_static/logo.png \ + Documentation/_static/overview.png \ Documentation/conf.py \ Documentation/index.rst \ Documentation/contents.rst \ Documentation/intro/index.rst \ + Documentation/intro/what-is-ovs.rst \ Documentation/intro/why-ovs.rst \ Documentation/intro/install/index.rst \ Documentation/intro/install/bash-completion.rst \ diff --git a/Documentation/index.rst b/Documentation/index.rst index 5a925135f..e4e98cb29 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -48,6 +48,9 @@ First Steps Getting started with Open vSwitch (OVS) or Open Virtual Network (OVN) for Open vSwitch? Start here. +- **Overview:** :doc:`intro/what-is-ovs` | + :doc:`intro/why-ovs` + - **Install:** :doc:`intro/install/general` | :doc:`intro/install/userspace` | :doc:`intro/install/netbsd` | diff --git a/Documentation/intro/index.rst b/Documentation/intro/index.rst index 7ad8bf383..0ad7ad1dc 100644 --- a/Documentation/intro/index.rst +++ b/Documentation/intro/index.rst @@ -32,5 +32,6 @@ How to get started with Open vSwitch. .. toctree:: :maxdepth: 2 + what-is-ovs why-ovs install/index diff --git a/Documentation/intro/what-is-ovs.rst b/Documentation/intro/what-is-ovs.rst new file mode 100644 index 000000000..bf7071f7a --- /dev/null +++ b/Documentation/intro/what-is-ovs.rst @@ -0,0 +1,41 @@ +.. + Copyright (c) 2016, Stephen Finucane + + Licensed under the Apache License, Version 2.0 (the "License"); you may + not use this file except in compliance with the License. You may obtain + a copy of the License at + + http://www.apache.org/licenses/LICENSE-2.0 + + Unless required by applicable law or agreed to in writing, software + distributed under the License is distributed on an "AS IS" BASIS, WITHOUT + WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the + License for the specific language governing permissions and limitations + under the License. + + Convention for heading levels in Open vSwitch documentation: + + ======= Heading 0 (reserved for the title in a document) + ------- Heading 1 + ~~~~~~~ Heading 2 + +++++++ Heading 3 + ''''''' Heading 4 + + Avoid deeper levels because they do not render well. + +===================== +What Is Open vSwitch? +===================== + +.. image:: ../_static/overview.png + :align: center + +Overview +-------- + +.. NOTE(stephenfin): The below line numbers may need to be updated if the + README is modified + +.. include:: ../../README.rst + :start-line: 13 + :end-line: 71 -- cgit v1.2.1