From: Trevor Bramwell Date: Thu, 1 Jul 2021 22:56:09 +0000 (-0700) Subject: Fix formatting, remove dead links/outdated docs X-Git-Url: https://gerrit.opnfv.org/gerrit/gitweb?a=commitdiff_plain;h=0b8891b33062a91a9185f5cf40494d65cf3e4fe0;p=opnfvdocs.git Fix formatting, remove dead links/outdated docs - Removes the outdated scenario documentation These docs included links to images that no longer exist - Removes the broken links to apex, sfc, clover, doctor, and ipv6 These no longer work as the infersphinx linking has been removedA - Removes links to missing documents - Fixes a minor issues with the index header - Updates the docs-linkcheck tox environment with the correct path to requirements.txt - Replaces the IRC link to Slack Signed-off-by: Trevor Bramwell --- diff --git a/docs/development/scenario/featurematrix.rst b/docs/development/scenario/featurematrix.rst deleted file mode 100644 index 2d00a4097..000000000 --- a/docs/development/scenario/featurematrix.rst +++ /dev/null @@ -1,39 +0,0 @@ -Each scenario provides a set of platform capabilities and features that it supports. It is -possible to identify which features are provided by reviewing the scenario name, however -not all features and capabilities are discernible from the name itself. - -Brahmaputra feature support matrix -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -The following table provides an overview of the available scenarios and supported features -in the Brahmaputra release of OPNFV. - -.. image:: ../images/brahmaputrafeaturematrix.jpg - :alt: OPNFV Brahmaputra Feature Matrix - -The table above provides an overview of which scenarios will support certain feature capabilities. -The table does not indicate if the feature or scenario has limitations. Refer to the -`Configuration Guide `_ -for details on the state of each scenario and further information. - -Feature development in the Brahmaputra release often consisted of the development of specific -requirements and the further integration and validation of those requirements. This results in some -features only being supported on the platform when a specific scenario, providing the -capabilities necessary to run the feature, is deployed. - -Scenario Naming -^^^^^^^^^^^^^^^ - -In OPNFV, scenarios are identified by short scenario names. These names follow a scheme that -identifies the key components and behaviours of the scenario, the rules for scenario naming are as follows: - - os-[controller]-[feature]-[mode]-[option] - -For example: *os-nosdn-kvm-noha* provides an OpenStack based deployment using neutron including -the OPNFV enhanced KVM hypervisor. - -The [feature] tag in the scenario name describes the main feature provided by the scenario. -This scenario may also provide support for features, such as advanced fault management, which are -not apparent in the scenario name. -The following section describes the features available in each scenario. - diff --git a/docs/development/scenario/scenariointro.rst b/docs/development/scenario/scenariointro.rst deleted file mode 100644 index dd808432b..000000000 --- a/docs/development/scenario/scenariointro.rst +++ /dev/null @@ -1,13 +0,0 @@ -OPNFV Scenarios ---------------- - -The OPNFV project provides an integration and deployment environment for a variety of components -that can make up a virtualisation platform. OPNFV identifies these variations on the composition of -the platform as scenarios. - -A scenario in OPNFV can be defined as "a deployment of a specific set of platform components". The -composition of a scenario may include specific SDN controller technologies, specific accelerate -switching technologies, or even specific configurations of components to achieve targeted platform -capabilities. Each scenario behaves differetly and it is important to understand the behaviour you -want in order to target the specific scenario you wish to deploy prior to working with the -OPNFV platform. diff --git a/docs/development/scenario/scenariomatrix.rst b/docs/development/scenario/scenariomatrix.rst deleted file mode 100644 index 64e115015..000000000 --- a/docs/development/scenario/scenariomatrix.rst +++ /dev/null @@ -1,100 +0,0 @@ -Scenarios are implemented as deployable compositions through integration with an installation tool. -OPNFV supports multiple installation tools and for any given release not all tools will support all -scenarios. While our target is to establish parity across the installation tools to ensure they -can provide all scenarios, the practical challenge of achieving that goal for any given feature and -release results in some disparity. - -Brahmaputra scenario overeview -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ - -The following table provides an overview of the installation tools and available scenario's -in the Brahmaputra release of OPNFV. - -.. image:: ../images/brahmaputrascenariomatrix.jpg - :alt: OPNFV Brahmaputra Scenario Matrix - -Scenario status is indicated by a weather pattern icon. All scenarios listed with -a weather pattern are possible to deploy and run in your environment or a Pharos lab, -however they may have known limitations or issues as indicated by the icon. - -Weather pattern icon legend: - -+---------------------------------------------+----------------------------------------------------------+ -| Weather Icon | Scenario Status | -+=============================================+==========================================================+ -| .. image:: ../images/weather-clear.jpg | Stable, no known issues | -+---------------------------------------------+----------------------------------------------------------+ -| .. image:: ../images/weather-few-clouds.jpg | Stable, documented limitations | -+---------------------------------------------+----------------------------------------------------------+ -| .. image:: ../images/weather-overcast.jpg | Deployable, stability or feature limitations | -+---------------------------------------------+----------------------------------------------------------+ -| .. image:: ../images/weather-dash.jpg | Not deployed with this installer | -+---------------------------------------------+----------------------------------------------------------+ - -Scenarios that are not yet in a state of "Stable, no known issues" will continue to be stabilised -and updates will be made on the stable/brahmaputra branch. While we intend that all Brahmaputra -scenarios should be stable it is worth checking regularly to see the current status. Due to -our dependency on upstream communities and code some issues may not be resolved prior to the C release. - -Scenario Naming -^^^^^^^^^^^^^^^ - -In OPNFV scenarios are identified by short scenario names, these names follow a scheme that -identifies the key components and behaviours of the scenario. The rules for scenario naming are as follows: - - os-[controller]-[feature]-[mode]-[option] - -Details of the fields are - * os: mandatory - - * Refers to the platform type used - * possible value: os (OpenStack) - -* [controller]: mandatory - - * Refers to the SDN controller integrated in the platform - * example values: nosdn, ocl, odl, onos - - * [feature]: mandatory - - * Refers to the feature projects supported by the scenario - * example values: nofeature, kvm, ovs, sfc - - * [mode]: mandatory - - * Refers to the deployment type, which may include for instance high availability - * possible values: ha, noha - - * [option]: optional - - * Used for the scenarios those do not fit into naming scheme. - * The optional field in the short scenario name should not be included if there is no optional scenario. - -Some examples of supported scenario names are: - - * os-nosdn-kvm-noha - - * This is an OpenStack based deployment using neutron including the OPNFV enhanced KVM hypervisor - - * os-onos-nofeature-ha - - * This is an OpenStack deployment in high availability mode including ONOS as the SDN controller - - * os-odl_l2-sfc - - * This is an OpenStack deployment using OpenDaylight and OVS enabled with SFC features - -Installing your scenario -^^^^^^^^^^^^^^^^^^^^^^^^ - -There are two main methods of deploying your target scenario, one method is to follow this guide which will -walk you through the process of deploying to your hardware using scripts or ISO images, the other method is -to set up a Jenkins slave and connect your infrastructure to the OPNFV Jenkins master. - -For the purposes of evaluation and development a number of Brahmaputra scenarios are able to be deployed -virtually to mitigate the requirements on physical infrastructure. Details and instructions on performing -virtual deployments can be found in the installer specific installation instructions. - -To set up a Jenkins slave for automated deployment to your lab, refer to the `Jenkins slave connect guide. -`_ - diff --git a/docs/development/scenario/scenariovalidation.rst b/docs/development/scenario/scenariovalidation.rst deleted file mode 100644 index e69de29bb..000000000 diff --git a/docs/featureprojects.rst b/docs/featureprojects.rst index 56c2f2c9e..e27b23405 100644 --- a/docs/featureprojects.rst +++ b/docs/featureprojects.rst @@ -3,20 +3,12 @@ OPNFV Projects ============== -Apex ----- - -* :doc:`Apex Overview ` -* :doc:`Apex Installation instructions ` - - Availability ------------ * :doc:`Availability overview ` * :doc:`High Availability Requirement Analysis in OPNFV ` - Barometer --------- @@ -26,40 +18,8 @@ Barometer * :doc:`Barometer User Guide ` * :doc:`Barometer Design Guide ` -Clover ------- - -* :doc:`Clover Overview ` - -Doctor ------- - -* :doc:`Doctor overview ` -* :doc:`Doctor Requirements ` -* :doc:`Doctor Config Guide ` -* :doc:`Doctor User Guide ` -* :doc:`Doctor Design Guide ` -* :doc:`OpenStack NOVA API for marking host down ` - Edgecloud --------- * :doc:`Edgecloud Overview ` * :doc:`Edgecloud Requirements ` - -IPV6 ----- - -* :doc:`IPV6 Overview ` -* :doc:`IPV6 Installation Guide ` -* :doc:`IPV6 Config Guide ` -* :doc:`IPV6 User Guide ` - -SFC ---- - -* :doc:`SFC Overview ` -* :doc:`SFC Requirements ` -* :doc:`SFC Config Guide ` -* :doc:`SFC User Guide ` -* :doc:`SFC Devlopment Guide ` diff --git a/docs/how-to-use-docs/index.rst b/docs/how-to-use-docs/index.rst index c56ff40ce..424f47189 100644 --- a/docs/how-to-use-docs/index.rst +++ b/docs/how-to-use-docs/index.rst @@ -9,5 +9,4 @@ Documentation Guide documentation-guide include-documentation - local-build-transition addendum diff --git a/docs/index.rst b/docs/index.rst index 5df6a027c..24eb381dc 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -2,7 +2,7 @@ .. SPDX-License-Identifier: CC-BY-4.0 Anuket Documentation -=================== +==================== The Anuket project facilitates the development and evolution of cloud components across various open source ecosystems. @@ -50,6 +50,6 @@ Developer Guide how-to-use-docs/index Found a typo or any other feedback? Send an email to users@opnfv.org or -talk to us on IRC_. +talk to us on Slack_. -.. _IRC: https://webchat.freenode.net/?channels=%23opnfv +.. _Slack: https://anuketworkspace.slack.com/ diff --git a/docs/release/installation.introduction.rst b/docs/release/installation.introduction.rst index c313046d5..a226055cf 100644 --- a/docs/release/installation.introduction.rst +++ b/docs/release/installation.introduction.rst @@ -44,4 +44,5 @@ Anuket Reference Specifications There is no need to "install" the Anuket Reference Specifications! You can view them here: .. * :doc:`Anuket Reference Specifications ` + * `Anuket Reference Specifications `_ diff --git a/docs/testing/developer/devguide/index.rst b/docs/testing/developer/devguide/index.rst index 1c7576b97..93faaffed 100644 --- a/docs/testing/developer/devguide/index.rst +++ b/docs/testing/developer/devguide/index.rst @@ -11,5 +11,4 @@ Test Framework Overview .. toctree:: :maxdepth: 2 - ./abstract ./dev-guide diff --git a/docs/testing/ecosystem/index.rst b/docs/testing/ecosystem/index.rst index 669f5cc19..f8532403c 100644 --- a/docs/testing/ecosystem/index.rst +++ b/docs/testing/ecosystem/index.rst @@ -9,6 +9,5 @@ Testing Framework Overview .. toctree:: :maxdepth: 2 - ./abstract ./overview diff --git a/tox.ini b/tox.ini index 5901c6be4..d262976e4 100644 --- a/tox.ini +++ b/tox.ini @@ -11,5 +11,5 @@ commands = whitelist_externals = echo [testenv:docs-linkcheck] -deps = -r{toxinidir}/etc/requirements.txt -commands = sphinx-build -b linkcheck -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck \ No newline at end of file +deps = -r{toxinidir}/docs/requirements.txt +commands = sphinx-build -b linkcheck -d {envtmpdir}/doctrees ./docs/ {toxinidir}/docs/_build/linkcheck