DOCS-1166 revising the replica state chart

Author: Sam Kleinman

source/includes/replica-states.rst

@@ -1,15 +1,51 @@
-==========  ==========================================================
-**Number**  **State**
-----------  ----------------------------------------------------------
-0           Starting up, phase 1 (parsing configuration)
-1           Primary
-2           Secondary
-3           Recovering (initial syncing, post-rollback, stale members)
-4           Fatal error
-5           Starting up, phase 2 (forking threads)
-6           Unknown state (the set has never connected to the member)
-7           Arbiter
-8           Down
-9           Rollback
-10          Removed
-==========  ==========================================================
+.. list-table::
+   :header-rows: 1
+   :widths: 15,25,60
+
+   * - **Number**
+     - **Name**
+     - **State**
+
+   * - 0
+     - ``STARTUP``
+     - Start up, phase 1 (parsing configuration.)
+
+   * - 1
+     - ``PRIMARY``
+     - Primary.
+
+   * - 2
+     - ``SECONDARY``
+     - Secondary.
+
+   * - 3
+     - ``RECOVERING``
+     - Member is recovering (initial sync, post-rollback, stale members.)
+
+   * - 4
+     - ``FATAL``
+     - Member has encountered an unrecoverable error.
+
+   * - 5
+     - ``STARTUP2``
+     - Start up, phase 2 (forking threads.)
+
+   * - 6
+     - ``UNKNOWN``
+     - Unknown (the set has never connected to the member.)
+
+   * - 7
+     - ``ARBITER``
+     - Member is an :term:`arbiter`.
+
+   * - 8
+     - ``DOWN``
+     - Member is not accessible to the set.
+
+   * - 9
+     - ``ROLLBACK``
+     - Member is rolling back data. See :term:`rollback`.
+
+   * - 10
+     - ``SHUNNED``
+     - Member has been removed from replica set.