DOCSP-27062 Adds Interlinks for mongosh Role Methods (#2275) (#2318)

* DOCSP-27062 Adds interlinks for db.% mongosh methods managing roles

* Adds interlinks

* Adds interlinks

* Build

* Build

* Removes old wrapper comment

Author: kennethdyer

source/reference/command/createRole.txt

@@ -21,6 +21,10 @@ Definition
    command returns a *duplicate role* error if the role already exists in
    the database.
 
+   .. |method| replace:: :method:`db.createRole` helper method
+   .. include:: /includes/fact-dbcommand-tip
+
+
 Syntax
 ------
 

source/reference/command/dropAllRolesFromDatabase.txt

@@ -23,6 +23,10 @@ Definition
       The :dbcommand:`dropAllRolesFromDatabase` removes *all*
       :ref:`user-defined <user-defined-roles>` roles from the database.
 
+   .. |method| replace:: :method:`db.dropAllRoles` helper method
+   .. include:: /includes/fact-dbcommand-tip
+
+
 Syntax
 ------
 

source/reference/command/dropRole.txt

@@ -18,6 +18,9 @@ Definition
    Deletes a :ref:`user-defined <user-defined-roles>` role from the
    database on which you run the command.
 
+   .. |method| replace:: :method:`db.dropRole` helper method
+   .. include:: /includes/fact-dbcommand-tip
+
 Syntax
 ------
 

source/reference/command/grantPrivilegesToRole.txt

@@ -17,8 +17,12 @@ Definition
 
    Assigns additional :ref:`privileges <privileges>` to a :ref:`user-defined
    <user-defined-roles>` role defined on the database on which the
-   command is run. The :dbcommand:`grantPrivilegesToRole` command uses
-   the following syntax:
+   command is run. 
+   
+   .. |method| replace:: :method:`db.grantPrivilegesToRole` helper method
+   .. include:: /includes/fact-dbcommand-tip
+
+   The :dbcommand:`grantPrivilegesToRole` command uses the following syntax:
 
 .. code-block:: javascript
 

source/reference/command/grantRolesToRole.txt

@@ -17,6 +17,9 @@ Definition
 
    Grants roles to a :ref:`user-defined role <user-defined-roles>`.
 
+   .. |method| replace:: :method:`db.grantRolesToRole` helper method
+   .. include:: /includes/fact-dbcommand-tip
+
    The :dbcommand:`grantRolesToRole` command affects roles on the
    database where the command runs. 
 

source/reference/command/revokePrivilegesFromRole.txt

@@ -19,6 +19,9 @@ Definition
    <user-defined-roles>` role on the database where the
    command is run. 
 
+   .. |method| replace:: :method:`db.revokePrivilegesFromRole` helper method
+   .. include:: /includes/fact-dbcommand-tip
+
 Syntax
 ------
 

source/reference/command/revokeRolesFromRole.txt

@@ -17,6 +17,9 @@ Definition
 
    Removes the specified inherited roles from a role. 
 
+   .. |method| replace:: :method:`db.revokeRolesFromRole` helper method
+   .. include:: /includes/fact-dbcommand-tip
+
 Syntax
 ------
 

source/reference/command/updateRole.txt

@@ -18,6 +18,9 @@ Definition
    Updates a :ref:`user-defined role <user-defined-roles>`. The
    :dbcommand:`updateRole` command must run on the role's database.
 
+   .. |method| replace:: :method:`db.updateRole` helper method
+   .. include:: /includes/fact-dbcommand-tip
+
    An update to a field **completely replaces** the previous field's values.
    To grant or remove roles or :ref:`privileges <privileges>` without
    replacing all values, use one or more of the following commands:

source/reference/method/db.createRole.txt

@@ -20,6 +20,9 @@ Definition
    inherit privileges from other roles or both. The role applies to
    the database on which you run the method.
 
+   .. |dbcommand| replace:: :dbcommand:`createRole` command
+   .. include:: /includes/fact-mongosh-shell-method-alt.rst
+
    The :method:`db.createRole()` method accepts the following arguments:
 
 
@@ -113,12 +116,6 @@ Definition
 
           .. include:: /includes/fact-auth-restrictions-role-desc.rst
 
-          
-   
-
-
-   The :method:`db.createRole()` method wraps the :dbcommand:`createRole`
-   command.
 
 Roles
 ~~~~~

source/reference/method/db.dropAllRoles.txt

@@ -23,6 +23,9 @@ Definition
       The :method:`db.dropAllRoles()` method removes *all*
       :ref:`user-defined <user-defined-roles>` roles from the database.
 
+   .. |dbcommand| replace:: :dbcommand:`dropAllRolesFromDatabase` command
+   .. include:: /includes/fact-mongosh-shell-method-alt.rst
+
    The :method:`db.dropAllRoles()` method takes the following argument:
 
 
@@ -44,9 +47,6 @@ Definition
    :returns:
       The number of :ref:`user-defined <user-defined-roles>` roles dropped.
 
-   The :method:`db.dropAllRoles()` method wraps the
-   :dbcommand:`dropAllRolesFromDatabase` command.
-
    .. |local-cmd-name| replace:: :method:`db.dropAllRoles()`
 
 Behavior

source/reference/method/db.dropRole.txt

@@ -18,6 +18,9 @@ Definition
    Deletes a :ref:`user-defined <user-defined-roles>` role from the
    database on which you run the method.
 
+   .. |dbcommand| replace:: :dbcommand:`dropRole` command
+   .. include:: /includes/fact-mongosh-shell-method-alt.rst
+
    The :method:`db.dropRole()` method takes the following arguments:
 
 
@@ -36,9 +39,6 @@ Definition
         - document
         - .. include:: /includes/fact-write-concern-spec-link.rst
 
-   The :method:`db.dropRole()` method wraps the :dbcommand:`dropRole`
-   command.
-
    .. |local-cmd-name| replace:: :method:`db.dropRole()`
 
 Behavior

source/reference/method/db.grantPrivilegesToRole.txt

@@ -18,6 +18,9 @@ Definition
    Grants additional :ref:`privileges <privileges>` to a :ref:`user-defined
    <user-defined-roles>` role.
 
+   .. |dbcommand| replace:: :dbcommand:`grantPrivilegesToRole` command
+   .. include:: /includes/fact-mongosh-shell-method-alt.rst
+
    The :method:`db.grantPrivilegesToRole()` method uses the following syntax:
 
    .. code-block:: javascript
@@ -61,9 +64,6 @@ Definition
 
    .. |local-cmd-name| replace:: :method:`db.grantPrivilegesToRole()`
 
-   The :method:`db.grantPrivilegesToRole()` method wraps the
-   :dbcommand:`grantPrivilegesToRole` command.
-
 Behavior
 --------
 

source/reference/method/db.grantRolesToRole.txt

@@ -17,6 +17,9 @@ Definition
 
    Grants roles to a :ref:`user-defined role <user-defined-roles>`.
 
+   .. |dbcommand| replace:: :dbcommand:`grantRolesToRole` command
+   .. include:: /includes/fact-mongosh-shell-method-alt.rst
+
    The :method:`db.grantRolesToRole()` method uses the following syntax:
 
    .. code-block:: javascript
@@ -47,9 +50,6 @@ Definition
    .. |local-cmd-name| replace:: :method:`db.grantRolesToRole()`
    .. include:: /includes/fact-roles-array-contents.rst
 
-   The :method:`db.grantRolesToRole()` method wraps the
-   :dbcommand:`grantRolesToRole` command.
-
 Behavior
 --------
 

source/reference/method/db.revokePrivilegesFromRole.txt

@@ -16,8 +16,12 @@ Definition
 .. method:: db.revokePrivilegesFromRole(rolename, privileges, writeConcern)
 
    Removes the specified privileges from the :ref:`user-defined
-   <user-defined-roles>` role on the database where the method runs. The
-   :method:`db.revokePrivilegesFromRole` method has the following syntax:
+   <user-defined-roles>` role on the database where the method runs. 
+   
+   .. |dbcommand| replace:: :dbcommand:`revokePrivilegesFromRole` command
+   .. include:: /includes/fact-mongosh-shell-method-alt.rst
+
+   The :method:`db.revokePrivilegesFromRole` method has the following syntax:
 
    .. code-block:: javascript
 
@@ -53,8 +57,6 @@ Definition
         - document
         - .. include:: /includes/fact-write-concern-spec-link.rst
 
-   The :method:`db.revokePrivilegesFromRole()` method wraps the
-   :dbcommand:`revokePrivilegesFromRole` command.
 
 Behavior
 --------

source/reference/method/db.revokeRolesFromRole.txt

@@ -17,6 +17,9 @@ Definition
 
    Removes the specified inherited roles from a role.
 
+   .. |dbcommand| replace:: :dbcommand:`revokeRolesFromRole` command
+   .. include:: /includes/fact-mongosh-shell-method-alt.rst
+
    The :method:`db.revokeRolesFromRole()` method uses the following syntax:
 
    .. code-block:: javascript
@@ -46,9 +49,6 @@ Definition
    .. |local-cmd-name| replace:: :method:`db.revokeRolesFromRole()`
    .. include:: /includes/fact-roles-array-contents.rst
 
-   The :method:`db.revokeRolesFromRole()` method wraps the
-   :dbcommand:`revokeRolesFromRole` command.
-
 Behavior
 --------
 

source/reference/method/db.updateRole.txt

@@ -18,6 +18,9 @@ Definition
    Updates a :ref:`user-defined role <user-defined-roles>`. The
    :method:`db.updateRole()` method must run on the role's database.
 
+   .. |dbcommand| replace:: :dbcommand:`updateRole` command
+   .. include:: /includes/fact-mongosh-shell-method-alt.rst
+
    An update to a field **completely replaces** the previous field's values.
    To grant or remove roles or :ref:`privileges <privileges>` without
    replacing all values, use one or more of the following methods: