From d8690d3ab1c99e679fa708f782b4662dc31b80a6 Mon Sep 17 00:00:00 2001 From: ChristopherPrice Date: Thu, 7 Jan 2016 12:14:15 +0100 Subject: Small editorial changes to the template documents. Added reference sections without local placeholders. Restructured the user-guide index template. Change-Id: I8b2e6abbe151a8fb9f3721e761a65f70fada1e85 Signed-off-by: ChristopherPrice --- docs/configguide/index.rst | 12 ++++-------- docs/userguide/abstract.rst | 8 ++++++++ docs/userguide/index.rst | 15 +++++++++++---- docs/userguide/introduction.rst | 4 ++++ docs/userguide/onos.rst | 7 +++++++ docs/userguide/opendaylight.rst | 7 +++++++ docs/userguide/openstack.rst | 7 +++++++ docs/userguide/ovs.rst | 7 +++++++ docs/userguide/userguide.rst | 30 ------------------------------ 9 files changed, 55 insertions(+), 42 deletions(-) create mode 100644 docs/userguide/abstract.rst create mode 100644 docs/userguide/introduction.rst create mode 100644 docs/userguide/onos.rst create mode 100644 docs/userguide/opendaylight.rst create mode 100644 docs/userguide/openstack.rst create mode 100644 docs/userguide/ovs.rst delete mode 100644 docs/userguide/userguide.rst diff --git a/docs/configguide/index.rst b/docs/configguide/index.rst index 50deb6680..8a0f0d5fd 100644 --- a/docs/configguide/index.rst +++ b/docs/configguide/index.rst @@ -18,10 +18,8 @@ Contents: Installer Configuration ======================= -.. toctree:: - :maxdepth: 2 - - ./installerconfig +Waiting for the structue in the installer repo's to +add the include references. Feature Configuration ===================== @@ -31,10 +29,8 @@ Feature Configuration Post Configuration Activities ============================= -.. toctree:: - :maxdepth: 2 - - ./postinstall.rst +Waiting for the structue in the remote repo's to +add the include references. Indices and tables ================== diff --git a/docs/userguide/abstract.rst b/docs/userguide/abstract.rst new file mode 100644 index 000000000..b7b22aa5b --- /dev/null +++ b/docs/userguide/abstract.rst @@ -0,0 +1,8 @@ +Abstract +-------- + +This document provides guidance and instructions for using +features delivered in the Brahmaputra release of OPNFV. + +This document provides a guide for the usage of features and the +needed selection of tools and components as prerequisites. diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst index c78dd8624..6aea80894 100644 --- a/docs/userguide/index.rst +++ b/docs/userguide/index.rst @@ -6,15 +6,22 @@ Welcome to OPNFV User Guide =========================== -This guide seeks to inform operators how to use the OPNFV Platform and its components to enable platform -features provided in the Brahmaputra release. +.. toctree:: + :maxdepth: 2 + + abstract.rst + introduction.rst -Contents: +General system usage +==================== .. toctree:: :maxdepth: 2 - userguide.rst + openstack.rst + opendaylight.rst + onos.rst + ovs.rst Using Brahmaputra Features ========================== diff --git a/docs/userguide/introduction.rst b/docs/userguide/introduction.rst new file mode 100644 index 000000000..a492c6efb --- /dev/null +++ b/docs/userguide/introduction.rst @@ -0,0 +1,4 @@ +OPNFV User Guide +================ + +Outline the structure and composition of the User Guide in this section. diff --git a/docs/userguide/onos.rst b/docs/userguide/onos.rst new file mode 100644 index 000000000..0806caae5 --- /dev/null +++ b/docs/userguide/onos.rst @@ -0,0 +1,7 @@ +ONOS User Guide +======================= + +Add ONOS specific user guide information here. +Needs to include OPNFV default ports and addresses and +references to upstream documentation applicable for an +OPNFV deployment. diff --git a/docs/userguide/opendaylight.rst b/docs/userguide/opendaylight.rst new file mode 100644 index 000000000..6e43c05c5 --- /dev/null +++ b/docs/userguide/opendaylight.rst @@ -0,0 +1,7 @@ +OpenDaylight User Guide +======================= + +Add opendaylight specific user guide information here. +Needs to include OPNFV default ports and addresses and +references to upstream documentation applicable for an +OPNFV deployment. diff --git a/docs/userguide/openstack.rst b/docs/userguide/openstack.rst new file mode 100644 index 000000000..daeb5240f --- /dev/null +++ b/docs/userguide/openstack.rst @@ -0,0 +1,7 @@ +OpenStack User Guide +==================== + +Add openstack specific user guide information here. +Needs to include OPNFV default ports and addresses and +references to upstream documentation applicable for an +OPNFV deployment. diff --git a/docs/userguide/ovs.rst b/docs/userguide/ovs.rst new file mode 100644 index 000000000..9209ac61c --- /dev/null +++ b/docs/userguide/ovs.rst @@ -0,0 +1,7 @@ +OVS User Guide +============== + +Add OVS specific user guide information here. +Needs to include OPNFV default ports and addresses and +references to upstream documentation applicable for an +OPNFV deployment. diff --git a/docs/userguide/userguide.rst b/docs/userguide/userguide.rst deleted file mode 100644 index b129b5d2e..000000000 --- a/docs/userguide/userguide.rst +++ /dev/null @@ -1,30 +0,0 @@ - - -OPNFV User Guide -================ - -abstact.rst - -???????????????? -================ - -Table of content - -introduction.rst - -configuration-overview.rst - -General system usage -==================== -Openstack.rst -Opendaylight.rst -onos.rst -xxx.rst -xxx.rst - -Using Brahmaputra features -========================== -projectxyz.rst - - - -- cgit 1.2.3-korg