Docsp 34408 req roles v1.7 (#254)

* DOCSP-34408 Updates Role Requirements (#249)

* DOCSP-34408 Adds required role fore reversible sync

* Fixes widths

* Fixes columns

* Test hlist

* Test reformat

* Test reformat

* Test reformat

* Test reformat

* Test reformat

* Reworks reversing to use note directive

* Alphabetized roles lists

* Tries different column layout

* Reworks table

* Reworks table

* Reworks table

* Fixes per Ian

Co-authored-by: ianf-mongodb <[email protected]>

---------

Co-authored-by: ianf-mongodb <[email protected]>

* Fixes build issue

---------

Co-authored-by: ianf-mongodb <[email protected]>

Author: kennethdyer

source/includes/table-permissions-self-hosted.rst

@@ -1,50 +1,52 @@
 ..
-   Comment: The nested lists need blank lines before and after each list
-            plus extra indents 
+   Comment: The nested lists need extra indents.  Keep roles in alphabetic
+            order.
 
 .. list-table::
    :header-rows: 1
+   :stub-columns: 1
+   :widths: 20 40 40
 
    * - Sync Type
-     - Target
-     - Required Permissions
-
-   * - default
-     - source cluster
-     -
-
-         - readAnyDatabase
-         - backup
-         - clusterMonitor
-
-   * - default
-     - destination cluster
-     -
-
-         - readWriteAnyDatabase
-         - restore
-         - clusterMonitor
-         - clusterManager
-
-   * - write-blocking or reversing
-     - source cluster
-     -  
-
-         - readWriteAnyDatabase
-         - backup
-         - restore
-         - clusterMonitor
-         - clusterManager
-
-   * - write-blocking or reversing
-     - destination cluster
-     -
-
-         - readWriteAnyDatabase
-         - backup
-         - restore
-         - clusterMonitor
-         - clusterManager
+     - Required Source Permissions
+     - Required Destination Permissions
+
+   * - Default
+     - - :authrole:`backup`
+       - :authrole:`clusterMonitor`
+       - :authrole:`readAnyDatabase`
+
+     - - :authrole:`clusterManager`
+       - :authrole:`clusterMonitor`
+       - :authrole:`readWriteAnyDatabase`
+       - :authrole:`restore`
+
+   * - Write-blocking
+     - - :authrole:`backup`
+       - :authrole:`clusterManager`
+       - :authrole:`clusterMonitor`
+       - :authrole:`readWriteAnyDatabase`
+       - :authrole:`restore`
+
+     - - :authrole:`backup`
+       - :authrole:`clusterManager`
+       - :authrole:`clusterMonitor`
+       - :authrole:`readWriteAnyDatabase`
+       - :authrole:`restore`
+
+   * - Reversing
+     - - :authrole:`backup`
+       - :authrole:`clusterManager`
+       - :authrole:`clusterMonitor`
+       - :authrole:`readWriteAnyDatabase`
+       - :authrole:`restore`
+
+     - - :authrole:`backup`
+       - :authrole:`clusterManager`
+       - :authrole:`clusterMonitor`
+       - :authrole:`dbAdmin`
+       - :authrole:`readWriteAnyDatabase`
+       - :authrole:`restore`
 
 For details on server roles, see: :ref:`authorization`.