summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorRyota MIBU <r-mibu@cq.jp.nec.com>2016-02-02 00:24:22 +0900
committerRyota MIBU <r-mibu@cq.jp.nec.com>2016-02-02 00:24:22 +0900
commit9351f9aed9383b85173215cf892eef5b3fc44fc3 (patch)
tree0667990aa73e0653174fd3a8f398a943bd658c18 /docs
parent145ed01de3d50f82a9ed25ec1421651b8248df63 (diff)
fix section headers in consistent rule
'*' with overline: document title (placed before toctree) '=' with overline: sections '=': subsections '-': subsubsections Change-Id: Ia91ec0c4f95185eac911e972a07ebc7fdae372f4 Signed-off-by: Ryota MIBU <r-mibu@cq.jp.nec.com>
Diffstat (limited to 'docs')
-rw-r--r--docs/configguide/abstract.rst3
-rw-r--r--docs/configguide/configoptions.rst3
-rw-r--r--docs/configguide/feature-config.rst1
-rw-r--r--docs/configguide/index.rst11
-rw-r--r--docs/configguide/installer-config.rst1
-rw-r--r--docs/configguide/introduction.rst14
-rw-r--r--docs/configguide/post-install.rst1
-rw-r--r--docs/platformoverview/deploymenttools.rst7
-rw-r--r--docs/platformoverview/index.rst16
-rw-r--r--docs/platformoverview/introduction.rst6
-rw-r--r--docs/platformoverview/softwarearchitecture.rst4
-rw-r--r--docs/platformoverview/testcasesframework.rst8
-rw-r--r--docs/userguide/abstract.rst3
-rw-r--r--docs/userguide/feature-usage.rst1
-rw-r--r--docs/userguide/general-system.rst1
-rw-r--r--docs/userguide/index.rst8
-rw-r--r--docs/userguide/introduction.rst5
-rw-r--r--docs/userguide/onos.rst2
-rw-r--r--docs/userguide/opendaylight.rst2
-rw-r--r--docs/userguide/openstack.rst2
-rw-r--r--docs/userguide/ovs.rst2
21 files changed, 32 insertions, 69 deletions
diff --git a/docs/configguide/abstract.rst b/docs/configguide/abstract.rst
index 608ad0688..8005d86dd 100644
--- a/docs/configguide/abstract.rst
+++ b/docs/configguide/abstract.rst
@@ -1,5 +1,6 @@
+========
Abstract
---------
+========
This document provides guidance and instructions for the configuration
of the Brahmaputra release of OPNFV.
diff --git a/docs/configguide/configoptions.rst b/docs/configguide/configoptions.rst
index bf3dc3d08..f977ccf20 100644
--- a/docs/configguide/configoptions.rst
+++ b/docs/configguide/configoptions.rst
@@ -1,3 +1,4 @@
+=====================
Configuration Options
=====================
@@ -8,7 +9,7 @@ components such as OpenStack, OpenDaylight, OVS, KVM etc. where each scenario wi
include different source components or configurations.
OPNFV Scenario's
-----------------
+================
Each OPNFV scenario provides unique features and capabilities, it is important to understand
your target platform capabilities before installing and configuring your target scenario.
diff --git a/docs/configguide/feature-config.rst b/docs/configguide/feature-config.rst
index df9728bb9..1053807ad 100644
--- a/docs/configguide/feature-config.rst
+++ b/docs/configguide/feature-config.rst
@@ -1,3 +1,4 @@
+=====================
Feature Configuration
=====================
diff --git a/docs/configguide/index.rst b/docs/configguide/index.rst
index 0a47f1589..9e43a174f 100644
--- a/docs/configguide/index.rst
+++ b/docs/configguide/index.rst
@@ -1,19 +1,12 @@
+*************************
OPNFV Configuration Guide
-=========================
-
-Contents:
+*************************
.. toctree::
:maxdepth: 2
./abstract
- ./introduction
./configoptions
./installer-config
./feature-config
./post-install
-
-Indices and tables
-==================
-
-* :ref:`search`
diff --git a/docs/configguide/installer-config.rst b/docs/configguide/installer-config.rst
index 89632ea3f..00596db92 100644
--- a/docs/configguide/installer-config.rst
+++ b/docs/configguide/installer-config.rst
@@ -1,3 +1,4 @@
+=======================
Installer Configuration
=======================
diff --git a/docs/configguide/introduction.rst b/docs/configguide/introduction.rst
deleted file mode 100644
index 058514e20..000000000
--- a/docs/configguide/introduction.rst
+++ /dev/null
@@ -1,14 +0,0 @@
-Scope
-=====
-
-
-Using this guide
-----------------
-This section is probably wrong as we should dive straight into this, we have an abstract already.
-
-Pre-requisites
---------------
-
-
-
-
diff --git a/docs/configguide/post-install.rst b/docs/configguide/post-install.rst
index 88c12067d..663080d2a 100644
--- a/docs/configguide/post-install.rst
+++ b/docs/configguide/post-install.rst
@@ -1,3 +1,4 @@
+=============================
Post Configuration Activities
=============================
diff --git a/docs/platformoverview/deploymenttools.rst b/docs/platformoverview/deploymenttools.rst
index 996bca263..09ac5c1f5 100644
--- a/docs/platformoverview/deploymenttools.rst
+++ b/docs/platformoverview/deploymenttools.rst
@@ -1,6 +1,6 @@
-----------------
+================
Deployment Tools
-----------------
+================
Brahmaputra provides 4 different installers.
@@ -41,6 +41,3 @@ Joid
Editors note:
Just a high level intro and link to the main joid documents.
-
-
-
diff --git a/docs/platformoverview/index.rst b/docs/platformoverview/index.rst
index 6f01e571a..4c6db1200 100644
--- a/docs/platformoverview/index.rst
+++ b/docs/platformoverview/index.rst
@@ -1,13 +1,6 @@
-.. OPNFV Platform Overview documentation master file, created by
- sphinx-quickstart on Tue Nov 24 10:30:29 2015.
- You can adapt this file completely to your liking, but it should at least
- contain the root `toctree` directive.
-
+********************************
OPNFV Platform Overview document
-================================
-
-
-Contents:
+********************************
.. toctree::
:maxdepth: 2
@@ -16,8 +9,3 @@ Contents:
./softwarearchitecture.rst
./deploymenttools.rst
./testcasesframework.rst
-
-Indices and tables
-==================
-
-* :ref:`search`
diff --git a/docs/platformoverview/introduction.rst b/docs/platformoverview/introduction.rst
index 495655106..6d7c4c2e7 100644
--- a/docs/platformoverview/introduction.rst
+++ b/docs/platformoverview/introduction.rst
@@ -1,6 +1,6 @@
-------------------------
+============
Introduction
-------------------------
+============
The OPNFV project provides different kinds of output to its users:
@@ -62,5 +62,3 @@ later releases of OPNFV. Thus they are not part of a release package.
Also community labs are independent of releases. Only the lab description is included in
the release and describes the requirements of a lab to successfully run Brahmaputra
deployments.
-
-
diff --git a/docs/platformoverview/softwarearchitecture.rst b/docs/platformoverview/softwarearchitecture.rst
index c8593c4d1..6398bb0ed 100644
--- a/docs/platformoverview/softwarearchitecture.rst
+++ b/docs/platformoverview/softwarearchitecture.rst
@@ -1,6 +1,6 @@
-------------------------
+========================
Target software platform
-------------------------
+========================
Software architecture
=====================
diff --git a/docs/platformoverview/testcasesframework.rst b/docs/platformoverview/testcasesframework.rst
index f06c98b7a..e5cdaca44 100644
--- a/docs/platformoverview/testcasesframework.rst
+++ b/docs/platformoverview/testcasesframework.rst
@@ -1,10 +1,6 @@
------------------------
+=======================
Testcases and Framework
------------------------
+=======================
Editors note:
Just a high level description about the different types of tests and the role of yardstick as central framework.
-
-
-
-
diff --git a/docs/userguide/abstract.rst b/docs/userguide/abstract.rst
index 502c3fb5f..c2d93b98c 100644
--- a/docs/userguide/abstract.rst
+++ b/docs/userguide/abstract.rst
@@ -1,5 +1,6 @@
+========
Abstract
---------
+========
OPNFV is a collaborative project aimed at providing a variety of virtualisation
deployments intended to host applications serving the networking and carrier industry.
diff --git a/docs/userguide/feature-usage.rst b/docs/userguide/feature-usage.rst
index ea1e9e54e..8c69694b2 100644
--- a/docs/userguide/feature-usage.rst
+++ b/docs/userguide/feature-usage.rst
@@ -1,3 +1,4 @@
+==========================
Using Brahmaputra Features
==========================
diff --git a/docs/userguide/general-system.rst b/docs/userguide/general-system.rst
index 364fbce32..8920a2519 100644
--- a/docs/userguide/general-system.rst
+++ b/docs/userguide/general-system.rst
@@ -1,3 +1,4 @@
+============================
Usage of platform components
============================
diff --git a/docs/userguide/index.rst b/docs/userguide/index.rst
index 023c1d317..6ad11efef 100644
--- a/docs/userguide/index.rst
+++ b/docs/userguide/index.rst
@@ -1,5 +1,6 @@
+****************
OPNFV User Guide
-================
+****************
.. toctree::
:maxdepth: 2
@@ -8,8 +9,3 @@ OPNFV User Guide
./introduction
./general-system
./feature-usage
-
-Indices and tables
-==================
-
-* :ref:`search`
diff --git a/docs/userguide/introduction.rst b/docs/userguide/introduction.rst
index 9ac9f0814..c1ab145bc 100644
--- a/docs/userguide/introduction.rst
+++ b/docs/userguide/introduction.rst
@@ -1,3 +1,4 @@
+========
Overview
========
@@ -13,7 +14,7 @@ enable specific features and capabilities in the platform that can be leveraged
OPNFV user community.
OPNFV Scenarios
-----------------
+===============
Each OPNFV scenario provides unique features and capabilities, it is important to
ensure you have a scenario deployed on your infrastructure that provides the right capabilities
@@ -37,7 +38,7 @@ provide information about the specific use cases that have been validated and ar
on your deployment.
General usage guidelines
-------------------------
+========================
The user guide for OPNFV features and capabilities provide step by step instructions
for using features that have been configured according to the installation and configuration
diff --git a/docs/userguide/onos.rst b/docs/userguide/onos.rst
index d4fdb59c1..c68801eaf 100644
--- a/docs/userguide/onos.rst
+++ b/docs/userguide/onos.rst
@@ -1,5 +1,5 @@
ONOS User Guide
----------------
+===============
Add ONOS specific user guide information here.
Needs to include OPNFV default ports and addresses and
diff --git a/docs/userguide/opendaylight.rst b/docs/userguide/opendaylight.rst
index 3616307e7..6e43c05c5 100644
--- a/docs/userguide/opendaylight.rst
+++ b/docs/userguide/opendaylight.rst
@@ -1,5 +1,5 @@
OpenDaylight User Guide
------------------------
+=======================
Add opendaylight specific user guide information here.
Needs to include OPNFV default ports and addresses and
diff --git a/docs/userguide/openstack.rst b/docs/userguide/openstack.rst
index 069dc4b76..daeb5240f 100644
--- a/docs/userguide/openstack.rst
+++ b/docs/userguide/openstack.rst
@@ -1,5 +1,5 @@
OpenStack User Guide
---------------------
+====================
Add openstack specific user guide information here.
Needs to include OPNFV default ports and addresses and
diff --git a/docs/userguide/ovs.rst b/docs/userguide/ovs.rst
index 10e65baeb..9209ac61c 100644
--- a/docs/userguide/ovs.rst
+++ b/docs/userguide/ovs.rst
@@ -1,5 +1,5 @@
OVS User Guide
---------------
+==============
Add OVS specific user guide information here.
Needs to include OPNFV default ports and addresses and