Adding new structure for the genesis requirements doc.

Also aligned heading levels for readability.

Change-Id: I1e673637c044dc84201e922c9d8b4e3142a2ad27
Signed-off-by: ChristopherPrice <christopher.price@ericsson.com>
(cherry picked from commit 923a3c337a44ee44a5a673b0bec8fe46c4b24096)

4 files changed, 1 insertions, 301 deletions

diff --git a/docs/sources/artifacts-location.rst b/docs/sources/artifacts-location.rst
index 8b674f0..468b9dd 100644
--- a/docs/sources/artifacts-location.rst
+++ b/docs/sources/artifacts-location.rst
@@ -19,8 +19,6 @@ VM manager components
 
 * OpenStack::
   location: `<http://docs.openstack.org/releases/releases/liberty.html>`_
-  release: Liberty
-
   joid_location: cloud-archive:liberty
   release: Liberty
 
@@ -99,3 +97,4 @@ JOID components
       branch: "lp:~wuwenbin2/onosfw/onos-controller"
       branch: "lp:~wuwenbin2/onosfw/neutron-api-onos"
       branch: "lp:~wuwenbin2/onosfw/openvswitch-onos"
+
diff --git a/docs/sources/req-summary-support-matrix.rst b/docs/sources/req-summary-support-matrix.rst
deleted file mode 100644
index 307b059..0000000
--- a/docs/sources/req-summary-support-matrix.rst
+++ /dev/null
@@ -1,88 +0,0 @@
-===============================
-Deployment tools support matrix
-===============================
-
-This document provides a summary view of the features and capabilities of deployment
-tools (a.k.a. "installers") which are expected to be common for all deployment tools.
-
-The tables below only show a short abbreviation of the requirement. For details,
-please refer to detailed UX-requirements and system-requirements documents.
-
-
-Target system requirements
---------------------------
-
-+----------------------------------------------+------------+-----------+------------+------------+
-| Feature                                      | Apex       | Compass   | Fuel       | JOID/Juju  |
-+==============================================+============+===========+============+============+
-| GENESIS-4  - Centos7 or Ubuntu 14.04         | yes        | yes       | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-53 - OpenStack Heat                  | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-6  - OpenDaylight Beryllium          | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-49 - ONOSFW                          | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-8  - KVM Hypervisor                  | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-
-
-User experience requirements
-----------------------------
-
-+----------------------------------------------+------------+-----------+------------+------------+
-| Feature                                      | Apex       | Compass   | Fuel       | JOID/Juju  |
-+==============================================+============+===========+============+============+
-| GENESIS-9  - OpenStack HA                    | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-71 - Hitless hardware upgrade        | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-20 - Server discovery integrated     | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-28 - Common configuration file       | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-43 - DHCP server HA per tenant       | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-44 - SDN Controller L3               | yes        |           | yes        | no         |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-61 - L1/2 networking config          | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-62 - Logical networks                | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-72 - L3-neutron agent                | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-69 - Isolated CEPH OSD               | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-12 - Version control for components  | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-16 - Common inventory config         | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-17 - User-facing config files        | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-18 - Server roles                    | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-19 - Automatic device discovery      | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-25 - NTP config                      | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-40 - Hardware replacement support    | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-74 - "all-in-one" build              | yes        |           | yes        | n/a        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-31 - Agnostic to type of hard drive  | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-23 - Mandatory Access Control        | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-24 - Install ssh keys                | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-39 - Use artifacts from upstream     | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-38 - Deploy script for jumphost      | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-42 - Offline deployment              | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-34 - User guide                      | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-| GENESIS-35 - Release notes                   | yes        |           | yes        | yes        |
-+----------------------------------------------+------------+-----------+------------+------------+
-
diff --git a/docs/sources/system-requirements.rst b/docs/sources/system-requirements.rst
deleted file mode 100644
index 9dc08f1..0000000
--- a/docs/sources/system-requirements.rst
+++ /dev/null
@@ -1,64 +0,0 @@
-.. Copyright 2015 Open Platform for NFV Project, Inc. and its contributors
-
-.. This work is licensed under the
-.. Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-
-.. -----------------------------------------------------------------------
-
-.. Document to list the requirements the target system a
-   particular installer creates.
-   Please add a bullet each for every requirement added.
-
-==========================
-Target system requirements
-==========================
-
-Release: OPNFV Brahmaputra
-
-This document lists requirements for the target system that
-an installer creates. Different from the requirements document
-on user-experience, this document focuses on the key hardware
-and software components the different deployment tools install
-and/or configure.
-
-
-Minimum base Operating System distribution supported:
-=====================================================
-
-* `GENESIS-4 <https://jira.opnfv.org/browse/GENESIS-4>`_:
-  Installers should support either Centos 7 or Ubuntu 14.04
-  as target system base OS.
-
-Components/features installed for OpenStack:
-============================================
-
-* `GENESIS-53 <https://jira.opnfv.org/browse/GENESIS-53>`_:
-  OpenStack Heat should be installed.
-
-Minimum base OpenStack distribution supported:
-==============================================
-
-* `GENESIS-7 <https://jira.opnfv.org/browse/GENESIS-7>`_:
-  Installers should support OpenStack Liberty release.
-
-SDN Controller:
-===============
-
-* `GENESIS-6 <https://jira.opnfv.org/browse/GENESIS-6>`_:
-  Installers should support OpenDaylight Beryllium Release.
-
-* `GENESIS-49 <https://jira.opnfv.org/browse/GENESIS-49>`_:
-  Installers should support ONOSFW.
-
-VM Controller:
-==============
-
-Hypervisor:
-===========
-
-* `GENESIS-8 <https://jira.opnfv.org/browse/GENESIS-8>`_:
-  Installers should support KVM hypervisor.
-
-Virtual forwarder:
-==================
diff --git a/docs/sources/ux-requirements.rst b/docs/sources/ux-requirements.rst
deleted file mode 100644
index ec63d01..0000000
--- a/docs/sources/ux-requirements.rst
+++ /dev/null
@@ -1,147 +0,0 @@
-.. Copyright 2015 Open Platform for NFV Project, Inc. and its contributors
-
-.. This work is licensed under the
-.. Creative Commons Attribution 4.0 International License.
-.. http://creativecommons.org/licenses/by/4.0
-
-===============
-UX requirements
-===============
-
-Release: OPNFV Brahmaputra
-
-Requirements for a common user-experience created by the deployment tools.
-
-High availability requirements
-------------------------------
-.. Please add the story reference to each requirement.
-
-* `GENESIS-9 <https://jira.opnfv.org/browse/GENESIS-9>`_:
-  Installers shall support the deployment of OpenStack with
-  High-Availability (for those components that support it in
-  Liberty) on 3 or more control nodes. Functest tests should
-  be able to verify that the HA is enabled and functional.
-
-* `GENESIS-71 <https://jira.opnfv.org/browse/GENESIS-71>`_:
-  Hitless hardware upgrade: Increase size of a deployment in terms of compute
-  nodes (add additional compute nodes) without service interruption.
-  This requirement doesn't mandate upgrade/increasing the size of the control
-  node cluster.
-
-
-Network setup and configuration related requirements
-----------------------------------------------------
-* `GENESIS-20 <https://jira.opnfv.org/browse/GENESIS-20>`_:
-  Automatically populate discovered servers into install
-  tool (reduce user-intervention to a minimum).
-
-* `GENESIS-28 <https://jira.opnfv.org/browse/GENESIS-28>`_:
-  Installers should support a common configuration file (e.g. kickstart file)
-  per platform/role, so that the installed OS can be customized
-  for hardware and role.
-
-* `GENESIS-43 <https://jira.opnfv.org/browse/GENESIS-43>`_:
-  Neutron DHCP servers should be configured in HA per tenant.
-
-* `GENESIS-44 <https://jira.opnfv.org/browse/GENESIS-44>`_:
-  SDN Controller layer 3 forwarding support.
-
-* `GENESIS-61 <https://jira.opnfv.org/browse/GENESIS-61>`_:
-  Support layer 1/2 networking configuration.
-
-* `GENESIS-62 <https://jira.opnfv.org/browse/GENESIS-62>`_:
-  Support logical networks for target system.
-
-* `GENESIS-72 <https://jira.opnfv.org/browse/GENESIS-72>`_:
-  Support L3-neutron agent as an option for L3.
-
-* `GENESIS-69 <https://jira.opnfv.org/browse/GENESIS-69>`_:
-  Provide isolated compute node resources for CEPH OSD.
-
-Versioning requirements
------------------------
-.. Please add the story reference to each requirement.
-
-* `GENESIS-12 <https://jira.opnfv.org/browse/GENESIS-12>`_:
-  Installers should track/control all versions of all components pulled
-  from external sources (user should be able to identify
-  the versions and origins of all software components deployed).
-
-System definition and system configuration requirements
--------------------------------------------------------
-.. Please add the story reference to each requirement.
-
-* `GENESIS-16 <https://jira.opnfv.org/browse/GENESIS-16>`_:
-  Common ability to input site, topology, and server information.
-* `GENESIS-17 <https://jira.opnfv.org/browse/GENESIS-17>`_:
-  User-configurable parameters available via config files.
-* `GENESIS-18 <https://jira.opnfv.org/browse/GENESIS-18>`_:
-  Allow assignment of different roles to servers, so that hardware and
-  software can be configured according to the role.
-* `GENESIS-19 <https://jira.opnfv.org/browse/GENESIS-19>`_:
-  Deployment tool to provide for automatic device discovery.
-* `GENESIS-25 <https://jira.opnfv.org/browse/GENESIS-25>`_:
-  Installers should configure NTP servers on the servers for clock
-  synchronization.
-* `GENESIS-40 <https://jira.opnfv.org/browse/GENESIS-40>`_:
-  Hardware replacement.
-
-Requirements pertaining to the qualities of the deployment process
-------------------------------------------------------------------
-
-* `GENESIS-74 <https://jira.opnfv.org/browse/GENESIS-74>`_:
-  Installers which create a build for Brahmaputra, should create
-  the build as an "all-in-one" build. The the build process of
-  the installer creates a single entity (e.g. ISO) - which has
-  all the artifacts considered and required by all the projects
-  for Brahmaputra packaged in. Or in other terms and as an example:
-  If there are 4 different versions of OVS - all these 4 versions
-  would be contained in the "all in one build".
-  Note: This requirement only applies to installers which support
-  a "build" phase (i.e. create a bootable image, like an iso-image
-  from the different artifacts required).
-* `GENESIS-31 <https://jira.opnfv.org/browse/GENESIS-31>`_:
-  Installers to be agnostic to type of hard drives used.
-
-Security related requirements
------------------------------
-
-* `GENESIS-23 <https://jira.opnfv.org/browse/GENESIS-23>`_:
-  Installers should enable Mandatory Access Control by default.
-  Installers should enable MAC either using SElinux or AppArmour.
-* `GENESIS-24 <https://jira.opnfv.org/browse/GENESIS-24>`_:
-  Installers should install ssh keys on servers so that key-based login
-  can be used for administration.
-
-Testing related requirements
-----------------------------
-.. Please add the story reference to each requirement.
-
-Installation method related requirements
-----------------------------------------
-
-* `GENESIS-39 <https://jira.opnfv.org/browse/GENESIS-39>`_:
-  Ability to install with upstream artifacts.
-
-* `GENESIS-38 <https://jira.opnfv.org/browse/GENESIS-38>`_:
-  Installers should supply a script or set of scripts ("deploy.sh") to
-  automatically install the jumphost (from there, the
-  entire OPNFV system is automatically installed).
-
-* `GENESIS-42 <https://jira.opnfv.org/browse/GENESIS-42>`_:
-  Installers should support offline deployment. Jump host may have
-  Internet access, but the installers should support offline
-  installation on target hosts during the deployment phase (either
-  manually or automatically).
-
-Documentation related requirements
-----------------------------------
-
-* `GENESIS-34 <https://jira.opnfv.org/browse/GENESIS-34>`_:
-  Installers should provide a user guide.
-
-* `GENESIS-35 <https://jira.opnfv.org/browse/GENESIS-35>`_:
-  Installers should provide release notes for an OPNFV release as part of
-  the documentation provided.
-
-