docs: add status for force10 os

... and detail as much hidden configuration detail
to aid operators to understand what they might need to
do to leverage OS9 and OS10 switches.

Change-Id: I05989ba756605056ff4cf027dcee4ee05daebbe4

Author: juliakreger

doc/source/supported-devices.rst

@@ -12,8 +12,8 @@ The following devices are supported by this plugin:
 * Cisco NX-OS switches (Nexus)
 * Cumulus Linux (via NCLU)
 * Cumulus Linux (via NVUE)
-* Dell Force10
-* Dell OS10
+* Dell Force10 (netmiko_dell_force10)
+* Dell OS10 (netmiko_dell_os10)
 * Dell PowerConnect
 * HPE 5900 Series switches
 * Huawei switches
@@ -32,4 +32,49 @@ of any type.
 
 These device plugins use `Netmiko <https://github.com/ktbyers/netmiko>`_
 library, which in turn uses `Paramiko` library to access and configure
-the switches via SSH protocol.
+the switches via the SSH protocol.
+
+Dell Force10 OS9 (netmiko_dell_force10)
+---------------------------------------
+
+Known working firmware versions: 9.13.0.0
+
+Notes:
+
+ * Dell Force10 Simulator for 9.13.0 lacks the ability to set a switchport
+   mode to trunk, which prevents automated or even semi-automated testing.
+   That being said, creating VLANs and tagging/untagging works as expected.
+ * Uplink switchports to the rest of the network fabric must be configured in
+   advance if the ``ngs_trunk_ports`` switch device level configuration
+   option is *not* utilized.
+ * Use of SSH is expected and must be configured on the remote switch.
+ * Set each port to "switchport" to enable L2 switchport mode.
+ * Use of an "enable" secret through the switch level configuration option
+   ``secret`` was the tested path. Depending on precise switch configuration
+   and access control modeling, it may be possible to use without an enable
+   secret, but that has not been tested.
+
+Known Issues:
+
+ * `bug 2100641 <https://bugs.launchpad.net/ironic/+bug/2100641>`_ is
+   alieviated by setting a port to "switchport" *before* attempting to utilize
+   networking-generic-switch.
+
+Dell Force10 OS10 (netmiko_dell_os10)
+-------------------------------------
+
+Known working firmware version: 10.6.0.2.74
+
+Notes:
+
+ * Uplink switchports may need to be configured as Trunk ports prior to the
+   use of networking-generic-switch through a "switchport mode trunk" command.
+   Further specific trunk configuration may be necessary, however NGS can
+   leverage the ``ngs_trunk_ports`` configuration option and does appropriately
+   tag switchports as permitted when creating/deleting attachments.
+ * Password authentication for networking-generic-switch needs to be setup in
+   advance, specifically "ip ssh server enable" and
+   "ip ssh server password-authentication" commands.
+ * This driver was tested *without* the use of an enable secret to
+   permit a higher level of configuration access within the Switch.
+