summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorAric Gardner <agardner@linuxfoundation.org>2018-11-06 16:03:19 -0500
committerAric Gardner <agardner@linuxfoundation.org>2018-11-09 19:45:40 +0000
commit3f0076ecf3a52d2a415f16f4d4e76806c3ffa599 (patch)
tree3dedc394980cc08f9dc6e6653061a713da16cf0e
parent8f923f09008517c4933b026c700a35eaca348740 (diff)
Change submodules for :doc: for feature projects
In feature projects there were tons of broken links It does not make sense to link to anything but the projects index file here, as we do not control what the project does past having a doc/index.rst The infrastructure guide is in a better shape but has two broken links The projects that are inactive will show greyed out links untill they add an index.rst Change-Id: I9cba2cc7dd355e3ed90cfe72b3646f25cd76558a Signed-off-by: Aric Gardner <agardner@linuxfoundation.org> (cherry picked from commit 329c2fb5f670dca1063a6cc92eca416f90478239)
-rw-r--r--.gitignore4
-rw-r--r--docs/featureprojects.rst109
-rw-r--r--docs/index.rst2
-rw-r--r--docs/infrastructure/overview.rst8
-rw-r--r--docs/testing/testing-user.rst41
5 files changed, 37 insertions, 127 deletions
diff --git a/.gitignore b/.gitignore
index 7c47850..f0b2bd2 100644
--- a/.gitignore
+++ b/.gitignore
@@ -3,4 +3,6 @@
/docs_build/
/docs/projects/
/docs_output/
-/releng/ \ No newline at end of file
+/releng/
+.tox
+docs/_build/*
diff --git a/docs/featureprojects.rst b/docs/featureprojects.rst
index b2eac43..9b3ad39 100644
--- a/docs/featureprojects.rst
+++ b/docs/featureprojects.rst
@@ -8,21 +8,12 @@ Apex
.. toctree::
:maxdepth: 1
- ../submodules/apex/docs/development/overview/index
- ../submodules/apex/docs/development/requirements/index
- ../submodules/apex/docs/release/installation/index
- ../submodules/apex/docs/release/configguide/index
- ../submodules/apex/docs/release/userguide/index
- ../submodules/apex/docs/development/design/index
- ../submodules/apex/docs/development/manuals/index
-
+* :doc:`Apex Overview <apex:index>`
Armband
-------
* :doc:`Armband Overview <armband:index>`
-* :doc:`Installation Guide <armband:release/installation/index>`
-* :doc:`User Guide <armband:release/userguide/index>`
Availability
@@ -30,13 +21,7 @@ Availability
.. toctree::
:maxdepth: 1
- ../submodules/availability/docs/development/overview/index
- ../submodules/availability/docs/development/requirements/index
- ../submodules/availability/docs/release/installation/index
- ../submodules/availability/docs/release/configguide/index
- ../submodules/availability/docs/release/userguide/index
- ../submodules/availability/docs/development/design/index
- ../submodules/availability/docs/development/manuals/index
+* :doc:`Availability overview <availability:index>`
Barometer
@@ -44,145 +29,81 @@ Barometer
.. toctree::
:maxdepth: 1
- ../submodules/barometer/docs/development/overview/index
- ../submodules/barometer/docs/development/requirements/index
- ../submodules/barometer/docs/release/installation/index
- ../submodules/barometer/docs/release/configguide/index
- ../submodules/barometer/docs/release/userguide/index
- ../submodules/barometer/docs/development/design/index
- ../submodules/barometer/docs/development/manuals/index
+* :doc:`Barometer overview <barometer:index>`
Clover
------
.. toctree::
:maxdepth: 1
- ../submodules/clover/docs/development/design/index
- ../submodules/clover/docs/release/configguide/index
- ../submodules/clover/docs/release/userguide/index
+
+* :doc:`Clover overview <clover:index>`
Compass4Nfv
-----------
.. toctree::
:maxdepth: 1
- ../submodules/compass4nfv/docs/development/overview/index
- ../submodules/compass4nfv/docs/development/requirements/index
- ../submodules/compass4nfv/docs/release/installation/index
- ../submodules/compass4nfv/docs/release/configguide/index
- ../submodules/compass4nfv/docs/release/userguide/index
- ../submodules/compass4nfv/docs/development/design/index
- ../submodules/compass4nfv/docs/development/manuals/index
-
+* :doc:`Compass4nfv overview <compass4nfv:index>`
Daisy4NFV
---------
.. toctree::
:maxdepth: 1
- ../submodules/daisy/docs/development/design/index
- ../submodules/daisy/docs/release/configguide/index
- ../submodules/daisy/docs/release/installation/index
-
+* :doc:`Daisy overview <daisy:index>`
Doctor
------
.. toctree::
:maxdepth: 1
- ../submodules/doctor/docs/development/overview/index
- ../submodules/doctor/docs/development/requirements/index
- ../submodules/doctor/docs/release/installation/index
- ../submodules/doctor/docs/release/configguide/index
- ../submodules/doctor/docs/release/userguide/index
- ../submodules/doctor/docs/development/design/index
- ../submodules/doctor/docs/development/manuals/index
+* :doc:`Doctor overview <doctor:index>`
Edgecloud
---------
.. toctree::
:maxdepth: 1
- ../submodules/edgecloud/docs/development/requirements/index
+* :doc:`Edgecloud overview <edgecloud:index>`
IPV6
----
.. toctree::
:maxdepth: 1
- ../submodules/ipv6/docs/development/overview/index
- ../submodules/ipv6/docs/development/requirements/index
- ../submodules/ipv6/docs/release/installation/index
- ../submodules/ipv6/docs/release/configguide/index
- ../submodules/ipv6/docs/release/userguide/index
- ../submodules/ipv6/docs/development/design/index
- ../submodules/ipv6/docs/development/manuals/index
-
+* :doc:`IPV6 overview <ipv6:index>`
Joid
----
.. toctree::
:maxdepth: 1
- ../submodules/joid/docs/development/overview/index
- ../submodules/joid/docs/development/requirements/index
- ../submodules/joid/docs/release/installation/index
- ../submodules/joid/docs/release/configguide/index
- ../submodules/joid/docs/release/userguide/index
- ../submodules/joid/docs/development/design/index
- ../submodules/joid/docs/development/manuals/index
-
+* :doc:`JOID overview <joid:index>`
Opera
-----
.. toctree::
:maxdepth: 1
- ../submodules/opera/docs/development/overview/index
- ../submodules/opera/docs/development/requirements/index
- ../submodules/opera/docs/release/installation/index
- ../submodules/opera/docs/release/configguide/index
- ../submodules/opera/docs/release/userguide/index
- ../submodules/opera/docs/development/design/index
- ../submodules/opera/docs/development/manuals/index
-
+* :doc:`Opera overview <opera:index>`
Parser
------
.. toctree::
:maxdepth: 1
- ../submodules/parser/docs/development/overview/index
- ../submodules/parser/docs/development/requirements/index
- ../submodules/parser/docs/release/installation/index
- ../submodules/parser/docs/release/configguide/index
- ../submodules/parser/docs/release/userguide/index
- ../submodules/parser/docs/development/design/index
- ../submodules/parser/docs/development/manuals/index
-
+* :doc:`Parser overview <parser:index>`
SDNVPN
--------
.. toctree::
:maxdepth: 1
- ../submodules/sdnvpn/docs/development/overview/index
- ../submodules/sdnvpn/docs/development/requirements/index
- ../submodules/sdnvpn/docs/release/installation/index
- ../submodules/sdnvpn/docs/release/configguide/index
- ../submodules/sdnvpn/docs/release/userguide/index
- ../submodules/sdnvpn/docs/development/design/index
-
+* :doc:`Sdnvpn overview <sdnvpn:index>`
SFC
---
.. toctree::
:maxdepth: 1
- ../submodules/sfc/docs/development/overview/index
- ../submodules/sfc/docs/development/requirements/index
- ../submodules/sfc/docs/release/installation/index
- ../submodules/sfc/docs/release/configguide/index
- ../submodules/sfc/docs/release/userguide/index
- ../submodules/sfc/docs/development/design/index
- ../submodules/sfc/docs/development/manuals/index
-
+* :doc:`SFC overview <sfc:index>`
diff --git a/docs/index.rst b/docs/index.rst
index 191153f..8b683e5 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -57,7 +57,7 @@ Operations Supporting Tools
.. toctree::
:maxdepth: 1
- submodules/calipso/docs/release/index
+ :ref:`<calipso-release-guide>`
Found a typo or any other feedback? Send an email to users@opnfv.org or
talk to us on IRC_.
diff --git a/docs/infrastructure/overview.rst b/docs/infrastructure/overview.rst
index 3100907..3b15c0e 100644
--- a/docs/infrastructure/overview.rst
+++ b/docs/infrastructure/overview.rst
@@ -42,11 +42,3 @@ Software Infrastructure
-----------------------
- :ref:`releng:software-infrastructure`
-
-Security
---------
-
-.. toctree::
- :maxdepth: 1
-
- ../submodules/releng-anteater/docs/index
diff --git a/docs/testing/testing-user.rst b/docs/testing/testing-user.rst
index ade27a6..278b4a6 100644
--- a/docs/testing/testing-user.rst
+++ b/docs/testing/testing-user.rst
@@ -1,10 +1,3 @@
-.. _testing-userguide:
-
-.. This work is licensed under a Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-
-===================
-Testing User Guides
===================
This page provides the links to the installation, configuration and user guides
@@ -15,8 +8,8 @@ Bottlenecks
.. toctree::
:maxdepth: 1
- ../submodules/bottlenecks/docs/testing/user/configguide/index
- ../submodules/bottlenecks/docs/testing/user/userguide/index
+* :doc:`Bottlenecks Config Guide <bottlenecks:testing/user/configguide/index>`
+* :doc:`Bottlenecks User Guide <bottlenecks:testing/user/userguide/index>`
Dovetail / OPNFV Verified Program
@@ -24,27 +17,27 @@ Dovetail / OPNFV Verified Program
.. toctree::
:maxdepth: 1
- ../submodules/dovetail/docs/testing/user/certificationworkflow/index
- ../submodules/dovetail/docs/testing/user/ovpaddendum/index
- ../submodules/dovetail/docs/testing/user/reviewerguide/index
- ../submodules/dovetail/docs/testing/user/systempreparation/index
- ../submodules/dovetail/docs/testing/user/testspecification/index
- ../submodules/dovetail/docs/testing/user/userguide/index
+* :doc:`OVP Workflow <dovetail:testing/user/certificationworkflow/index>`
+* :doc:`Guidelines Addendum for 2018.09 release <dovetail:testing/user/ovpaddendum/index>`
+* :doc:`OVP Reviewer Guide <dovetail:testing/user/reviewerguide/index>`
+* :doc:`OVP System Preparation Guide <dovetail:testing/user/systempreparation/index>`
+* :doc:`OVP Testing Specification <dovetail:testing/user/testspecification/index>`
+* :doc:`OVP Testing User Guide <dovetail:testing/user/userguide/index>`
Functest
---------
.. toctree::
:maxdepth: 1
- ../submodules/functest/docs/testing/user/configguide/index
- ../submodules/functest/docs/testing/user/userguide/index
+* :doc:`Functest Installation Guide <functest:testing/user/configguide/index>`
+* :doc:`Functest User Guide <functest:testing/user/userguide/index>`
NFVbench
-----
.. toctree::
:maxdepth: 1
- ../submodules/nfvbench/docs/testing/user/userguide/index
+* :doc:`NFVbench User Guide <nfvbench:testing/user/userguide/index>`
Storperf
@@ -53,7 +46,7 @@ Storperf
.. toctree::
:maxdepth: 1
- ../submodules/storperf/docs/testing/user/index
+* :doc:`StorPerf User Guide <storperf:testing/user/index>`
VSPERF
@@ -62,8 +55,8 @@ VSPERF
.. toctree::
:maxdepth: 1
- ../submodules/vswitchperf/docs/testing/user/configguide/index
- ../submodules/vswitchperf/docs/testing/user/userguide/index
+* :doc:`VSPERF Configuration and User Guide <vswitchperf:testing/user/configguide/index>`
+* :doc:`VSPERF Test Guide <vswitchperf:testing/user/userguide/index>`
Yardstick
@@ -71,5 +64,7 @@ Yardstick
.. toctree::
:maxdepth: 1
- ../submodules/yardstick/docs/testing/user/configguide/index
- ../submodules/yardstick/docs/testing/user/userguide/index
+* :doc:`Yardstick Configuration Guide <yardstick:testing/user/configguide/index>`
+* :doc:`Yardstick User Guide <yardstick:testing/user/userguide/index>`
+
+