DOCSP-29565: Add example using --inheritedRole to customDbRoles create (#1924)

Co-authored-by: pierwill <[email protected]>
Co-authored-by: sarahsimpers <[email protected]>
Co-authored-by: Gustavo Bazan <[email protected]>

Author: 3 people

docs/atlascli/command/atlas-customDbRoles-create.txt

@@ -105,4 +105,11 @@ Examples
 
 .. code-block::
 
+   # Create a custom database role
    atlas customDbRoles create customRole --privilege FIND@database,UPDATE@database
+
+   
+.. code-block::
+
+   # Use an inherited role
+   atlas customDbRoles create customRole --inheritedRole read@database

docs/mongocli/command/mongocli-atlas-customDbRoles-create.txt

@@ -105,4 +105,11 @@ Examples
 
 .. code-block::
 
+   # Create a custom database role
    mongocli atlas customDbRoles create customRole --privilege FIND@database,UPDATE@database
+
+   
+.. code-block::
+
+   # Use an inherited role
+   mongocli atlas customDbRoles create customRole --inheritedRole read@database

internal/cli/atlas/customdbroles/create.go

@@ -80,11 +80,15 @@ func (opts *CreateOpts) validate() error {
 func CreateBuilder() *cobra.Command {
 	opts := &CreateOpts{}
 	cmd := &cobra.Command{
-		Use:     "create <roleName>",
-		Short:   "Create a custom database role for your project.",
-		Long:    fmt.Sprintf(usage.RequiredRole, "Project Owner"),
-		Example: fmt.Sprintf(`  %s customDbRoles create customRole --privilege FIND@database,UPDATE@database`, cli.ExampleAtlasEntryPoint()),
-		Args:    require.ExactArgs(1),
+		Use:   "create <roleName>",
+		Short: "Create a custom database role for your project.",
+		Long:  fmt.Sprintf(usage.RequiredRole, "Project Owner"),
+		Example: fmt.Sprintf(`# Create a custom database role
+  %[1]s customDbRoles create customRole --privilege FIND@database,UPDATE@database
+
+  # Use an inherited role
+  %[1]s customDbRoles create customRole --inheritedRole read@database`, cli.ExampleAtlasEntryPoint()),
+		Args: require.ExactArgs(1),
 		Annotations: map[string]string{
 			"roleNameDesc": "Name of the custom role to create.",
 			"output":       createTemplate,