Merge branch 'sk/update-protect-graphql-mutations' into 'master'

Enhance security policy graphql mutation documentation

See merge request gitlab-org/gitlab!70721

doc/api/graphql/reference/index.md

@@ -3904,6 +3904,8 @@ Input type: `RunnersRegistrationTokenResetInput`
 
 ### `Mutation.scanExecutionPolicyCommit`
 
+Commits the `policy_yaml` content to the assigned security policy project for the given project(`project_path`).
+
 Input type: `ScanExecutionPolicyCommitInput`
 
 #### Arguments
@@ -3925,6 +3927,8 @@ Input type: `ScanExecutionPolicyCommitInput`
 
 ### `Mutation.securityPolicyProjectAssign`
 
+Assigns the specified project(`security_policy_project_id`) as security policy project for the given project(`project_path`). If the project already has a security policy project, this reassigns the project's security policy project with the given `security_policy_project_id`.
+
 Input type: `SecurityPolicyProjectAssignInput`
 
 #### Arguments
@@ -3944,6 +3948,8 @@ Input type: `SecurityPolicyProjectAssignInput`
 
 ### `Mutation.securityPolicyProjectCreate`
 
+Creates and assigns a security policy project for the given project(`project_path`).
+
 Input type: `SecurityPolicyProjectCreateInput`
 
 #### Arguments

ee/app/graphql/mutations/security_policy/assign_security_policy_project.rb

@@ -7,6 +7,10 @@ module Mutations
 
       graphql_name 'SecurityPolicyProjectAssign'
 
+      description 'Assigns the specified project(`security_policy_project_id`) as security policy project '\
+      'for the given project(`project_path`). If the project already has a security policy project, '\
+      'this reassigns the project\'s security policy project with the given `security_policy_project_id`'
+
       authorize :update_security_orchestration_policy_project
 
       argument :project_path, GraphQL::Types::ID,

ee/app/graphql/mutations/security_policy/commit_scan_execution_policy.rb

@@ -7,6 +7,8 @@ module Mutations
 
       graphql_name 'ScanExecutionPolicyCommit'
 
+      description 'Commits the `policy_yaml` content to the assigned security policy project for the given project(`project_path`)'
+
       authorize :security_orchestration_policies
 
       argument :project_path, GraphQL::Types::ID,

ee/app/graphql/mutations/security_policy/create_security_policy_project.rb

@@ -7,6 +7,8 @@ module Mutations
 
       graphql_name 'SecurityPolicyProjectCreate'
 
+      description 'Creates and assigns a security policy project for the given project(`project_path`)'
+
       authorize :update_security_orchestration_policy_project
 
       argument :project_path, GraphQL::Types::ID,