summaryrefslogtreecommitdiffstats
path: root/docs/userguide
diff options
context:
space:
mode:
authorChristopherPrice <christopher.price@ericsson.com>2016-08-11 08:25:14 +0200
committerChristopherPrice <christopher.price@ericsson.com>2016-08-12 13:16:07 +0200
commitf4011396e88647e9fbbb2b99b4cb6c6da54b70bd (patch)
treefddae233a312216b3d083a3057cdf7702644eba5 /docs/userguide
parentcf3dfbdea81f5bd444db0853681da6c52c20b2a6 (diff)
Applying the userguide template for the SDN VPN userguide documentation.
Added a draft of the scenario description template for consideration and review. This is a draft migrating the existing userguide text into the proposed feature project userguide format for Colorado. Please review and comment, correct and merge as needed. (this is the prototype) Change-Id: Ia82a0c3ba0f654efc2892aac3a3b2d217ed2ad27 Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
Diffstat (limited to 'docs/userguide')
-rw-r--r--docs/userguide/feature.userguide.rst42
-rw-r--r--docs/userguide/index.rst23
2 files changed, 65 insertions, 0 deletions
diff --git a/docs/userguide/feature.userguide.rst b/docs/userguide/feature.userguide.rst
new file mode 100644
index 0000000..a531fe2
--- /dev/null
+++ b/docs/userguide/feature.userguide.rst
@@ -0,0 +1,42 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Tim Irnich, (tim.irnich@ericsson.com) and others
+
+Introduction
+============
+.. Describe the specific features and how it is realised in the scenario in a brief manner
+.. to ensure the user understand the context for the user guide instructions to follow.
+
+This document will provide an overview of how to work with the SDN VPN features in
+OPNFV. For a description of the scenarios and their provided capabilities refer to
+the scenario description document:
+http://artifacts.opnfv.org/colorado/sdnpvn/scenarios/os-odl_l2-bgpvpn/index.html
+
+SDN VPN feature description
+===========================
+.. Describe the specific usage for <XYZ> feature.
+.. Provide enough information that a user will be able to operate the feature on a deployed scenario.
+
+The BGPVPN feature enables creation of BGP VPNs according to the OpenStack
+BGPVPN blueprint at https://blueprints.launchpad.net/neutron/+spec/neutron-bgp-vpn.
+In a nutshell, the blueprint defines a BGPVPN object and a number of ways
+how to associate it with the existing Neutron object model, including a unique
+definition of the related semantics. The BGPVPN framework supports a backend
+driver model with currently available drivers for Bagpipe, OpenContrail, Nuage
+and OpenDaylight.
+
+Feature and API usage guidelines and example
+============================================
+.. Describe with examples how to use specific features, provide API examples and details required to
+.. operate the feature on the platform.
+
+For the details of using OpenStack BGPVPN API, please refer to the documentation
+at http://docs.openstack.org/developer/networking-bgpvpn/.
+
+Can we give a basic example here? Pointing someone off to a generic document in reference to
+this specific compilation of components feels a little like only half the job. :)
+
+Troubleshooting
+===============
+
+What? I thought this would work!
diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst
new file mode 100644
index 0000000..0eab38c
--- /dev/null
+++ b/docs/userguide/index.rst
@@ -0,0 +1,23 @@
+.. This work is licensed under a Creative Commons Attribution 4.0 International License.
+.. http://creativecommons.org/licenses/by/4.0
+.. (c) Tim Irnich, (tim.irnich@ericsson.com) and others
+
+==================
+SDN VPN user guide
+==================
+
+.. The feature user guide should provide an OPNFV user with enough information to
+.. use the features provided by the feature project in the supported scenarios.
+.. This guide should walk a user through the usage of the features once a scenario
+.. has been deployed and is active according to the installation guide provided
+.. by the installer project.
+
+.. toctree::
+ :maxdepth: 3
+
+ ./feature.userguide.rst
+
+.. The feature.userguide.rst file should contain the text for this document
+.. additional documents can be added to this directory and added in the right order
+.. to this file as a list below.
+