Enumerate retired specs

We've been keeping a backlog of specs which are entirely outdated
and will never be implemented. And we should also indicate when
a specification document is no longer applicable at all. As such
this change adds a retired folder, enumeration, and moves four
documents to the retired folder to indcate they are no longer
applicable to Ironic so end users have appropriate context should
they discover the documents in the future.

Change-Id: I1ab7d6726dc45283ca72df1df1d3c18e8ae8ea94

doc/source/index.rst

@@ -422,6 +422,24 @@ Juno
 
    specs/approved/*
 
+
+Retired
+=======
+
+These specifications are ideas and features which are no longer applicable.
+They were either not implemented, no longer exist, and have generally been
+superceeded either through the evolution of the project's capabilities or
+the state in the marketplace. Each document listed below has been updated
+to indicate the context as to why it was moved to this list.
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   specs/retired/*
+
+
+
 ==================
 Indices and tables
 ==================

specs/approved/cisco-ucs-hw-inspection.rst

@@ -14,6 +14,11 @@ This proposal adds the ability to inspect/update hardware properties and
 auto-create ports for Cisco UCS B/C/M-servers managed by Cisco UCS Manager.
 It uses out-of-band H/W inspection utility provided by UcsSdk.
 
+.. NOTE::
+   This specification has been retired as the vendor specific UCS driers are
+   no longer available in Ironic. This was a result of the Open Source
+   UcsSdk library no longer being maintained.
+
 Problem description
 ===================
 

specs/approved/cisco-ucs-oob-raid-configuration.rst

@@ -14,6 +14,13 @@ This blueprint proposes to implement out-of-band RAID configuration interface
 for Cisco UCS drivers. This implementation supports configuration of Cisco
 UCS Manager (UCSM) managed B/C/M-series servers.
 
+.. NOTE::
+   This specification has been retired as the vendor specific UCS driers are
+   no longer available in Ironic. This was a result of the Open Source
+   UcsSdk library no longer being maintained. Users may wish to explore use
+   of the ``redfish`` driver, but it is unknown to the community if the UCS
+   Redfish support has been extended to RAID support.
+
 Problem description
 ===================
 

specs/retired/openbmc-driver.rst

@@ -13,6 +13,12 @@ https://bugs.launchpad.net/ironic/+bug/1634635
 This proposal covers the addition of power and management interfaces for
 OpenBMC and the addition of driver to the IPA and PXE driver classes.
 
+.. NOTE::
+   This specification is no longer viewed as applicable as OpenBMC has support
+   for the Redfish API interface, and as such this is considered a superior
+   standards based interface for use. When this specificaiton was proposed,
+   These the Redfish API had not yet been implemented in OpenBMC.
+
 Problem description
 ===================
 
@@ -45,7 +51,6 @@ OpenBMCPower in it's 'supported_power_interfaces' list. This hardware type
 will also have OpenBMCManagement in it's 'supported_management_interfaces'
 list.
 
-
 Alternatives
 ------------
 

specs/retired/petitboot-boot-driver.rst

@@ -14,6 +14,11 @@ This adds petitboot boot driver for OpenPOWER servers. The OpenPOWER
 Foundation is a collaboration around Power Architecture products initiated by
 IBM.
 
+.. NOTE::
+   This specification has been retired as the IBM firmware maintainers
+   added support for the classical PXELinux file format. As such, this
+   specification is no longer needed.
+
 Problem description
 ===================