Editorial updates to requirements docs

Updates to system-requirements and ux-requirements docs.
 - Fixed formatting
 - Fixed broken links
 - Moved documentation requirements from system-req
   document to ux-req document
 - Fixed (some) grammar

Note that non editorial fixes (e.g. removal for
certain requirements no longer apply to Brahmaputra
are handled in other patches). This patch is a replica
of 7435 which got abandoned due to merge issues.

Change-Id: Ibb914f523a7719f8240d4a690cd645f44500108e
Signed-off-by: Frank Brockners <fbrockne@cisco.com>

2 files changed, 92 insertions, 101 deletions

diff --git a/docs/sources/system-requirements.rst b/docs/sources/system-requirements.rst
index bbf916a..ca7af03 100644
--- a/docs/sources/system-requirements.rst
+++ b/docs/sources/system-requirements.rst
@@ -24,59 +24,49 @@ 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.
+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.
 
-Hardware components
--------------------
-.. Please add the Jira story reference to each requirement.
-   Note that the below listed "GENESIS-1" Jira story are place holders
-   and are to be changed for the actual Jira reference.
-
-
-Software components
--------------------
-.. Please add the Jira story to each requirement as reference.
 
 Minimum base Operating System distribution supported:
 =====================================================
-`GENESIS-4 <https://jira.opnfv.org/browse/GENESIS-4>`_: Installers support either Centos 7 or
-Ubuntu 14.04 as target system base OS
+
+* `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.
+* `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 must support OpenStack Liberty
-release
+
+* `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 support
-OpenDaylight Lithium Release
-
-`GENESIS-49 <https://jira.opnfv.org/browse/GENESIS-49>`_: Installers support for ONOSFW
+* `GENESIS-6 <https://jira.opnfv.org/browse/GENESIS-6>`_:
+  Installers should support OpenDaylight Lithium 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>`_: KVM Support
+
+* `GENESIS-8 <https://jira.opnfv.org/browse/GENESIS-8>`_:
+  Installers should support KVM hypervisor.
 
 Virtual forwarder:
 ==================
-
-
-Installer Documentation:
-========================
-
-`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
-
-
diff --git a/docs/sources/ux-requirements.rst b/docs/sources/ux-requirements.rst
index 0076f1f..a41995e 100644
--- a/docs/sources/ux-requirements.rst
+++ b/docs/sources/ux-requirements.rst
@@ -26,21 +26,17 @@ Release: OPNFV Brahmaputra
 
 Requirements for a common user-experience created by the deployment tools.
 
-
-
 High availability requirements
 ------------------------------
-.. Please add the Jira story reference to each requirement.
-   Note that the below listed "GENESIS-3" Jira story are place holders
-   and are to be changed for the actual Jira reference.
+.. Please add the story reference to each requirement.
 
-* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement...
-* `Jira GENESIS-9 <https://jira.opnfv.org/browse/GENESIS-9>`_: The installer 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-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.
 
-* `Jira GENESIS-71 <https://jira.opnfv.org/browse/GENESIS-71>`_: new requirement
+* `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
@@ -49,65 +45,65 @@ High availability requirements
 
 Network setup and configuration related requirements
 ----------------------------------------------------
-* `Jira GENESIS-20 <https://jira.opnfv.org/browse/GENESIS-20>`_: Automatically populate
-  discovered servers into install tool (reduce user-intervention to a minimum).
+* `GENESIS-20 <https://jira.opnfv.org/browse/GENESIS-20>`_:
+  Automatically populate discovered servers into install
+  tool (reduce user-intervention to a minimum).
 
-* `Jira 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-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.
 
-* `Jira GENESIS-43 <https://jira.opnfv.org/browse/GENESIS-43>`_: Neutron DHCP servers should
-  be configured in HA per tenant
+* `GENESIS-43 <https://jira.opnfv.org/browse/GENESIS-43>`_:
+  Neutron DHCP servers should be configured in HA per tenant.
 
-* `Jira GENESIS-44 <https://jira.opnfv.org/browse/GENESIS-44>`_: SDN Controller Layer 3 forwarding support
+* `GENESIS-44 <https://jira.opnfv.org/browse/GENESIS-44>`_:
+  SDN Controller layer 3 forwarding support.
 
-* `Jira GENESIS-61 <https://jira.opnfv.org/browse/GENESIS-61>`_: Supported Layer 1/2 Networking
-  Configurations
+* `GENESIS-61 <https://jira.opnfv.org/browse/GENESIS-61>`_:
+  Support layer 1/2 networking configuration.
 
-* `Jira GENESIS-62 <https://jira.opnfv.org/browse/GENESIS-62>`_: Supported Logical Networks for
-  Target System
+* `GENESIS-62 <https://jira.opnfv.org/browse/GENESIS-62>`_:
+  Support logical networks for target system.
 
-* `Jira GENESIS-72 <https://jira.opnfv.org/browse/GENESIS-72`_: Support L3-neutron agent
-  as an option for L3
+* `GENESIS-72 <https://jira.opnfv.org/browse/GENESIS-72>`_:
+  Support L3-neutron agent as an option for L3.
 
-* `Jira GENESIS-69 <https://jira.opnfv.org/browse/GENESIS-69`_: Provide isolated compute node 
-  resources for CEPH OSD
+* `GENESIS-69 <https://jira.opnfv.org/browse/GENESIS-69>`_:
+  Provide isolated compute node resources for CEPH OSD.
 
 Versioning requirements
 -----------------------
-.. Please add the Jira story reference to each requirement.
-   Note that the below listed "GENESIS-3" Jira stories are place holders
-   and are to be changed for the actual Jira reference.
+.. Please add the story reference to each requirement.
 
-* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement...
-* `Jira 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
+* `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 Jira story reference to each requirement.
-   Note that the below listed "GENESIS-3" Jira stories are place holders
-   and are to be changed for the actual Jira reference.
-
-* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement...
-* `Jira GENESIS-16 <https://jira.opnfv.org/browse/GENESIS-16>`_: Common ability to input site,
-  topology, and server information.
-* `Jira GENESIS-17 <https://jira.opnfv.org/browse/GENESIS-17>`_: User-configurable parameters
-  available via config files.
-* `Jira 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.
-* `Jira GENESIS-19 <https://jira.opnfv.org/browse/GENESIS-19>`_: 
+.. 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.
-* `Jira GENESIS-25 <https://jira.opnfv.org/browse/GENESIS-25`_:
+* `GENESIS-25 <https://jira.opnfv.org/browse/GENESIS-25>`_:
   Installers should configure NTP servers on the servers for clock
   synchronization.
-* `Jira GENESIS-40 <https://jira.opnfv.org/browse/GENESIS-40>`_: Hardware replacement
+* `GENESIS-40 <https://jira.opnfv.org/browse/GENESIS-40>`_:
+  Hardware replacement.
 
 Requirements pertaining to the qualities of the deployment process
 ------------------------------------------------------------------
 
-* `Jira GENESIS-74 <https://jira.opnfv.org/browse/GENESIS-74>`_:
+* `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
@@ -118,43 +114,48 @@ Requirements pertaining to the qualities of the deployment process
   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).
-* `Jira GENESIS-31 <https://jira.opnfv.org/browse/GENESIS-31>`_: Installers to be agnostic to
-  type of hard drives used
+* `GENESIS-31 <https://jira.opnfv.org/browse/GENESIS-31>`_:
+  Installers to be agnostic to type of hard drives used.
 
 Security related requirements
 -----------------------------
-.. Please add the Jira story reference to each requirement.
-   Note that the below listed "GENESIS-3" Jira stories are place holders
-   and are to be changed for the actual Jira reference.
 
-* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement...
-* `Jira GENESIS-23 <https://jira.opnfv.org/browse/GENESIS-23>`_: Enable Mandatory Access Control by default. Installer should enable MAC either using SElinux or AppArmour.
-* `Jira 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
+* `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 Jira story reference to each requirement.
-   Note that the below listed "GENESIS-3" Jira stories are place holders
-   and are to be changed for the actual Jira reference.
-
-* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement...
+.. Please add the story reference to each requirement.
 
 Installation method related requirements
 ----------------------------------------
-* `Jira GENESIS-39 <https://jira.opnfv.org/browse/GENESIS-39>`_: Ability to install with upstream
-  artifacts.
 
+* `GENESIS-39 <https://jira.opnfv.org/browse/GENESIS-39>`_:
+  Ability to install with upstream artifacts.
 
-* `Jira 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).
-
-* `Jira GENESIS-42 <https://jira.opnfv.org/browse/GENESIS-42>`: Requirement: Support deployment offline. Jump host may have Internet access, but the installers should support offline installation on target hosts during the deployment phase. (either manual or automatic)
+* `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
 ----------------------------------
-.. Please add the Jira story reference to each requirement.
-   Note that the below listed "GENESIS-3" Jira stories are place holders
-   and are to be changed for the actual Jira reference.
 
-* `Jira GENESIS-3 <https://jira.opnfv.org/browse/GENESIS-3>`_: new requirement...
+* `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.
+