Fix Rubocop Graphql/Description offenses

https://gitlab.com/gitlab-org/gitlab/-/issues/337596

.rubocop_manual_todo.yml

@@ -23,49 +23,6 @@ Graphql/Descriptions:
     - 'ee/app/graphql/types/vulnerability_severity_enum.rb'
     - 'ee/app/graphql/types/vulnerability_state_enum.rb'
     - 'ee/app/graphql/types/vulnerability_confidence_enum.rb'
-    - 'ee/app/graphql/resolvers/dora_metrics_resolver.rb'
-    - 'ee/app/graphql/resolvers/geo/geo_node_resolver.rb'
-    - 'ee/app/graphql/resolvers/network_policy_resolver.rb'
-    - 'ee/app/graphql/resolvers/requirements_management/requirements_resolver.rb'
-    - 'ee/app/graphql/types/alert_management/payload_alert_field_input_type.rb'
-    - 'ee/app/graphql/types/alert_management/payload_alert_mapping_field_type.rb'
-    - 'ee/app/graphql/types/analytics/devops_adoption/snapshot_type.rb'
-    - 'ee/app/graphql/types/app_sec/fuzzing/api/scan_profile_type.rb'
-    - 'ee/app/graphql/types/ci/code_quality_degradation_type.rb'
-    - 'ee/app/graphql/types/ci/minutes/namespace_monthly_usage_type.rb'
-    - 'ee/app/graphql/types/ci/minutes/project_monthly_usage_type.rb'
-    - 'ee/app/graphql/types/clusters/agent_token_type.rb'
-    - 'ee/app/graphql/types/clusters/agent_type.rb'
-    - 'ee/app/graphql/types/dast/profile_branch_type.rb'
-    - 'ee/app/graphql/types/dast/profile_type.rb'
-    - 'ee/app/graphql/types/dast/site_profile_auth_input_type.rb'
-    - 'ee/app/graphql/types/dast/site_profile_auth_type.rb'
-    - 'ee/app/graphql/types/dast_scanner_profile_type.rb'
-    - 'ee/app/graphql/types/dast_site_profile_type.rb'
-    - 'ee/app/graphql/types/epic_tree/epic_tree_node_input_type.rb'
-    - 'ee/app/graphql/types/epic_type.rb'
-    - 'ee/app/graphql/types/geo/geo_node_type.rb'
-    - 'ee/app/graphql/types/incident_management/escalation_policy_type.rb'
-    - 'ee/app/graphql/types/incident_management/escalation_rule_input_type.rb'
-    - 'ee/app/graphql/types/incident_management/escalation_rule_type.rb'
-    - 'ee/app/graphql/types/incident_management/oncall_participant_type.rb'
-    - 'ee/app/graphql/types/incident_management/oncall_rotation_active_period_input_type.rb'
-    - 'ee/app/graphql/types/incident_management/oncall_rotation_active_period_type.rb'
-    - 'ee/app/graphql/types/incident_management/oncall_rotation_date_input_type.rb'
-    - 'ee/app/graphql/types/incident_management/oncall_rotation_length_input_type.rb'
-    - 'ee/app/graphql/types/incident_management/oncall_user_input_type.rb'
-    - 'ee/app/graphql/types/move_type_enum.rb'
-    - 'ee/app/graphql/types/network_policy_kind_enum.rb'
-    - 'ee/app/graphql/types/path_lock_type.rb'
-    - 'ee/app/graphql/types/pipeline_security_report_finding_type.rb'
-    - 'ee/app/graphql/types/scanned_resource_type.rb'
-    - 'ee/app/graphql/types/security_report_summary_section_type.rb'
-    - 'ee/app/graphql/types/timebox_metrics_type.rb'
-    - 'ee/app/graphql/types/vulnerability/issue_link_type.rb'
-    - 'ee/app/graphql/types/vulnerability_details/commit_type.rb'
-    - 'ee/app/graphql/types/vulnerability_type.rb'
-    - 'ee/app/graphql/types/vulnerable_dependency_type.rb'
-    - 'ee/app/graphql/types/vulnerable_package_type.rb'
 
 # WIP: See https://gitlab.com/gitlab-org/gitlab/-/issues/220040
 Rails/SaveBang:

ee/app/graphql/resolvers/dora_metrics_resolver.rb

@@ -11,7 +11,7 @@ module Resolvers
 
     argument :metric, Types::DoraMetricTypeEnum,
              required: true,
-             description: 'The type of metric to return.'
+             description: 'Type of metric to return.'
 
     argument :start_date, Types::DateType,
              required: false,
@@ -27,7 +27,7 @@ module Resolvers
 
     argument :environment_tier, Types::DeploymentTierEnum,
              required: false,
-             description: 'The deployment tier of the environments to return. Defaults to `PRODUCTION`.'
+             description: 'Deployment tier of the environments to return. Defaults to `PRODUCTION`.'
 
     def resolve(params)
       result = ::Dora::AggregateMetricsService

ee/app/graphql/resolvers/geo/geo_node_resolver.rb

@@ -7,7 +7,7 @@ module Resolvers
 
       argument :name, GraphQL::Types::String,
                required: false,
-               description: 'The name of the Geo node. Defaults to the current Geo node name.'
+               description: 'Name of the Geo node. Defaults to the current Geo node name.'
 
       def resolve(name: GeoNode.current_node_name)
         GeoNodeFinder.new(context[:current_user], names: [name]).execute.first

ee/app/graphql/resolvers/network_policy_resolver.rb

@@ -10,7 +10,7 @@ module Resolvers
     argument :environment_id,
              ::Types::GlobalIDType[::Environment],
              required: false,
-             description: 'The global ID of the environment to filter policies.'
+             description: 'Global ID of the environment to filter policies.'
 
     alias_method :project, :object
 

ee/app/graphql/resolvers/requirements_management/requirements_resolver.rb

@@ -18,7 +18,7 @@ module Resolvers
 
       argument :last_test_report_state, ::Types::RequirementsManagement::RequirementStatusFilterEnum,
                required: false,
-               description: 'The state of latest requirement test report.'
+               description: 'State of latest requirement test report.'
 
       def resolve_with_lookahead(**args)
         # The project could have been loaded in batch by `BatchLoader`.

ee/app/graphql/types/alert_management/payload_alert_field_input_type.rb

@@ -9,7 +9,7 @@ module Types
       argument :field_name,
                 ::Types::AlertManagement::PayloadAlertFieldNameEnum,
                 required: true,
-                description: 'A GitLab alert field name.'
+                description: 'GitLab alert field name.'
 
       argument :path,
                [::Types::AlertManagement::PayloadAlertFieldPathSegmentType],

ee/app/graphql/types/alert_management/payload_alert_mapping_field_type.rb

@@ -11,7 +11,7 @@ module Types
       field :field_name,
             ::Types::AlertManagement::PayloadAlertFieldNameEnum,
             null: true,
-            description: 'A GitLab alert field name.'
+            description: 'GitLab alert field name.'
 
       field :path,
             [::Types::AlertManagement::PayloadAlertFieldPathSegmentType],

ee/app/graphql/types/analytics/devops_adoption/snapshot_type.rb

@@ -38,11 +38,11 @@ module Types
         field :total_projects_count, GraphQL::Types::Int, null: true,
               description: 'Total number of projects.'
         field :recorded_at, Types::TimeType, null: false,
-              description: 'The time the snapshot was recorded.'
+              description: 'Time the snapshot was recorded.'
         field :start_time, Types::TimeType, null: false,
-              description: 'The start time for the snapshot where the data points were collected.'
+              description: 'Start time for the snapshot where the data points were collected.'
         field :end_time, Types::TimeType, null: false,
-              description: 'The end time for the snapshot where the data points were collected.'
+              description: 'End time for the snapshot where the data points were collected.'
       end
     end
   end

ee/app/graphql/types/app_sec/fuzzing/api/scan_profile_type.rb

@@ -10,13 +10,13 @@ module Types
           description 'An API Fuzzing scan profile.'
 
           field :name, GraphQL::Types::String, null: true,
-                description: 'The unique name of the profile.'
+                description: 'Unique name of the profile.'
 
           field :description, GraphQL::Types::String, null: true,
-                description: 'A short description of the profile.'
+                description: 'Short description of the profile.'
 
           field :yaml, GraphQL::Types::String, null: true,
-                description: 'A syntax highlit HTML representation of the YAML.'
+                description: 'Syntax highlighted HTML representation of the YAML.'
         end
         # rubocop: enable Graphql/AuthorizeTypes
       end

ee/app/graphql/types/ci/code_quality_degradation_type.rb

@@ -12,23 +12,23 @@ module Types
       alias_method :degradation, :object
 
       field :description, GraphQL::Types::String, null: false,
-        description: "A description of the code quality degradation."
+        description: "Description of the code quality degradation."
 
       field :fingerprint, GraphQL::Types::String, null: false,
-        description: 'A unique fingerprint to identify the code quality degradation. For example, an MD5 hash.'
+        description: 'Unique fingerprint to identify the code quality degradation. For example, an MD5 hash.'
 
       field :severity, Types::Ci::CodeQualityDegradationSeverityEnum, null: false,
         description: "Status of the degradation (#{::Gitlab::Ci::Reports::CodequalityReports::SEVERITY_PRIORITIES.keys.map(&:upcase).join(', ')})."
 
       field :path, GraphQL::Types::String, null: false,
-        description: 'The relative path to the file containing the code quality degradation.'
+        description: 'Relative path to the file containing the code quality degradation.'
 
       def path
         degradation.dig(:location, :path)
       end
 
       field :line, GraphQL::Types::Int, null: false,
-        description: 'The line on which the code quality degradation occurred.'
+        description: 'Line on which the code quality degradation occurred.'
 
       def line
         degradation.dig(:location, :lines, :begin) || degradation.dig(:location, :positions, :begin, :line)

ee/app/graphql/types/ci/minutes/namespace_monthly_usage_type.rb

@@ -9,11 +9,11 @@ module Types
         graphql_name 'CiMinutesNamespaceMonthlyUsage'
 
         field :month, ::GraphQL::STRING_TYPE, null: true,
-              description: 'The month related to the usage data.'
+              description: 'Month related to the usage data.'
 
         field :minutes, ::GraphQL::INT_TYPE, null: true,
               method: :amount_used,
-              description: 'The total number of minutes used by all projects in the namespace.'
+              description: 'Total number of minutes used by all projects in the namespace.'
 
         field :projects, ::Types::Ci::Minutes::ProjectMonthlyUsageType.connection_type, null: true,
               description: 'CI minutes usage data for projects in the namespace.'

ee/app/graphql/types/ci/minutes/project_monthly_usage_type.rb

@@ -10,10 +10,10 @@ module Types
 
         field :minutes, ::GraphQL::INT_TYPE, null: true,
               method: :amount_used,
-              description: 'The number of CI minutes used by the project in the month.'
+              description: 'Number of CI minutes used by the project in the month.'
 
         field :name, ::GraphQL::STRING_TYPE, null: true,
-              description: 'The name of the project.'
+              description: 'Name of the project.'
 
         def name
           object.project.name

ee/app/graphql/types/clusters/agent_token_type.rb

@@ -22,7 +22,7 @@ module Types
       field :created_by_user,
             Types::UserType,
             null: true,
-            description: 'The user who created the token.'
+            description: 'User who created the token.'
 
       field :description,
             GraphQL::Types::String,

ee/app/graphql/types/clusters/agent_type.rb

@@ -29,7 +29,7 @@ module Types
             description: 'Name of the cluster agent.'
 
       field :project, Types::ProjectType,
-            description: 'The project this cluster agent is associated with.',
+            description: 'Project this cluster agent is associated with.',
             null: true,
             authorize: :read_project
 

ee/app/graphql/types/dast/profile_branch_type.rb

@@ -9,7 +9,7 @@ module Types
       authorize :read_on_demand_scans
 
       field :name, GraphQL::Types::String, null: true,
-            description: 'The name of the branch.',
+            description: 'Name of the branch.',
             calls_gitaly: true
 
       field :exists, GraphQL::Types::Boolean, null: true,

ee/app/graphql/types/dast/profile_type.rb

@@ -12,23 +12,23 @@ module Types
             description: 'ID of the profile.'
 
       field :name, GraphQL::Types::String, null: true,
-            description: 'The name of the profile.'
+            description: 'Name of the profile.'
 
       field :description, GraphQL::Types::String, null: true,
-            description: 'The description of the scan.'
+            description: 'Description of the scan.'
 
       field :dast_site_profile, DastSiteProfileType, null: true,
-            description: 'The associated site profile.'
+            description: 'Associated site profile.'
 
       field :dast_scanner_profile, DastScannerProfileType, null: true,
-            description: 'The associated scanner profile.'
+            description: 'Associated scanner profile.'
 
       field :dast_profile_schedule, ::Types::Dast::ProfileScheduleType, null: true,
             description: 'Associated profile schedule. Will always return `null` ' \
                          'if `dast_on_demand_scans_scheduler` feature flag is disabled.'
 
       field :branch, Dast::ProfileBranchType, null: true,
-            description: 'The associated branch.',
+            description: 'Associated branch.',
             calls_gitaly: true
 
       field :edit_path, GraphQL::Types::String, null: true,

ee/app/graphql/types/dast/site_profile_auth_input_type.rb

@@ -17,19 +17,19 @@ module Types
 
       argument :username_field, GraphQL::Types::String,
                required: false,
-               description: 'The name of username field at the sign-in HTML form.'
+               description: 'Name of username field at the sign-in HTML form.'
 
       argument :password_field, GraphQL::Types::String,
                required: false,
-               description: 'The name of password field at the sign-in HTML form.'
+               description: 'Name of password field at the sign-in HTML form.'
 
       argument :username, GraphQL::Types::String,
                required: false,
-               description: 'The username to authenticate with on the target website.'
+               description: 'Username to authenticate with on the target website.'
 
       argument :password, GraphQL::Types::String,
                required: false,
-               description: 'The password to authenticate with on the target website.'
+               description: 'Password to authenticate with on the target website.'
     end
   end
 end

ee/app/graphql/types/dast/site_profile_auth_type.rb

@@ -24,17 +24,17 @@ module Types
       field :username_field, GraphQL::Types::String,
             null: true,
             method: :auth_username_field,
-            description: 'The name of username field at the sign-in HTML form.'
+            description: 'Name of username field at the sign-in HTML form.'
 
       field :password_field, GraphQL::Types::String,
             null: true,
             method: :auth_password_field,
-            description: 'The name of password field at the sign-in HTML form.'
+            description: 'Name of password field at the sign-in HTML form.'
 
       field :username, GraphQL::Types::String,
             null: true,
             method: :auth_username,
-            description: 'The username to authenticate with on the target website.'
+            description: 'Username to authenticate with on the target website.'
 
       field :password, GraphQL::Types::String,
             null: true,

ee/app/graphql/types/dast_scanner_profile_type.rb

@@ -15,10 +15,10 @@ module Types
           method: :name
 
     field :spider_timeout, GraphQL::Types::Int, null: true,
-          description: 'The maximum number of minutes allowed for the spider to traverse the site.'
+          description: 'Maximum number of minutes allowed for the spider to traverse the site.'
 
     field :target_timeout, GraphQL::Types::Int, null: true,
-          description: 'The maximum number of seconds allowed for the site under test to respond to a request.'
+          description: 'Maximum number of seconds allowed for the site under test to respond to a request.'
 
     field :scan_type, Types::DastScanTypeEnum, null: true,
           description: 'Indicates the type of DAST scan that will run. ' \

ee/app/graphql/types/dast_site_profile_type.rb

@@ -17,14 +17,14 @@ module Types
           description: 'ID of the site profile.'
 
     field :profile_name, GraphQL::Types::String, null: true,
-          description: 'The name of the site profile.',
+          description: 'Name of the site profile.',
           method: :name
 
     field :target_url, GraphQL::Types::String, null: true,
-          description: 'The URL of the target to be scanned.'
+          description: 'URL of the target to be scanned.'
 
     field :target_type, Types::DastTargetTypeEnum, null: true,
-          description: 'The type of target to be scanned.'
+          description: 'Type of target to be scanned.'
 
     field :edit_path, GraphQL::Types::String, null: true,
           description: 'Relative web path to the edit page of a site profile.'
@@ -33,14 +33,14 @@ module Types
           description: 'Target authentication details.'
 
     field :excluded_urls, [GraphQL::Types::String], null: true,
-          description: 'The URLs to skip during an authenticated scan.'
+          description: 'URLs to skip during an authenticated scan.'
 
     field :request_headers, GraphQL::Types::String, null: true,
           description: 'Comma-separated list of request header names and values to be ' \
                        'added to every request made by DAST.'
 
     field :validation_status, Types::DastSiteProfileValidationStatusEnum, null: true,
-          description: 'The current validation status of the site profile.',
+          description: 'Current validation status of the site profile.',
           method: :status
 
     field :normalized_target_url, GraphQL::Types::String, null: true,

ee/app/graphql/types/epic_tree/epic_tree_node_input_type.rb

@@ -9,17 +9,17 @@ module Types
       argument :id,
                ::Types::GlobalIDType[::EpicTreeSorting],
                required: true,
-               description: 'The ID of the epic_issue or epic that is being moved.'
+               description: 'ID of the epic issue or epic that is being moved.'
 
       argument :adjacent_reference_id,
                ::Types::GlobalIDType[::EpicTreeSorting],
                required: false,
-               description: 'The ID of the epic_issue or issue that the actual epic or issue is switched with.'
+               description: 'ID of the epic issue or issue the epic or issue is switched with.'
 
       argument :relative_position,
                MoveTypeEnum,
                required: false,
-               description: 'The type of the switch, after or before allowed.'
+               description: 'Type of switch. Valid values are `after` or `before`.'
 
       argument :new_parent_id,
                ::Types::GlobalIDType[::Epic],

ee/app/graphql/types/epic_type.rb

@@ -104,7 +104,7 @@ module Types
           method: :group_epic_url
 
     field :relative_position, GraphQL::Types::Int, null: true,
-          description: 'The relative position of the epic in the epic tree.'
+          description: 'Relative position of the epic in the epic tree.'
     field :relation_path, GraphQL::Types::String, null: true,
            description: 'URI path of the epic-issue relationship.',
            method: :group_epic_link_path
@@ -145,7 +145,7 @@ module Types
     field :award_emoji,
           Types::AwardEmojis::AwardEmojiType.connection_type,
           null: true,
-          description: 'A list of award emojis associated with the epic.',
+          description: 'List of award emojis associated with the epic.',
           authorize: :read_emoji
 
     field :ancestors, Types::EpicType.connection_type,

ee/app/graphql/types/geo/geo_node_type.rb

@@ -10,18 +10,18 @@ module Types
       field :id, GraphQL::Types::ID, null: false, description: 'ID of this GeoNode.'
       field :primary, GraphQL::Types::Boolean, null: true, description: 'Indicates whether this Geo node is the primary.'
       field :enabled, GraphQL::Types::Boolean, null: true, description: 'Indicates whether this Geo node is enabled.'
-      field :name, GraphQL::Types::String, null: true, description: 'The unique identifier for this Geo node.'
-      field :url, GraphQL::Types::String, null: true, description: 'The user-facing URL for this Geo node.'
-      field :internal_url, GraphQL::Types::String, null: true, description: 'The URL defined on the primary node that secondary nodes should use to contact it.'
-      field :files_max_capacity, GraphQL::Types::Int, null: true, description: 'The maximum concurrency of LFS/attachment backfill for this secondary node.'
-      field :repos_max_capacity, GraphQL::Types::Int, null: true, description: 'The maximum concurrency of repository backfill for this secondary node.'
-      field :verification_max_capacity, GraphQL::Types::Int, null: true, description: 'The maximum concurrency of repository verification for this secondary node.'
-      field :container_repositories_max_capacity, GraphQL::Types::Int, null: true, description: 'The maximum concurrency of container repository sync for this secondary node.'
+      field :name, GraphQL::Types::String, null: true, description: 'Unique identifier for this Geo node.'
+      field :url, GraphQL::Types::String, null: true, description: 'User-facing URL for this Geo node.'
+      field :internal_url, GraphQL::Types::String, null: true, description: 'URL defined on the primary node secondary nodes should use to contact it.'
+      field :files_max_capacity, GraphQL::Types::Int, null: true, description: 'Maximum concurrency of LFS/attachment backfill for this secondary node.'
+      field :repos_max_capacity, GraphQL::Types::Int, null: true, description: 'Maximum concurrency of repository backfill for this secondary node.'
+      field :verification_max_capacity, GraphQL::Types::Int, null: true, description: 'Maximum concurrency of repository verification for this secondary node.'
+      field :container_repositories_max_capacity, GraphQL::Types::Int, null: true, description: 'Maximum concurrency of container repository sync for this secondary node.'
       field :sync_object_storage, GraphQL::Types::Boolean, null: true, description: 'Indicates if this secondary node will replicate blobs in Object Storage.'
       field :selective_sync_type, GraphQL::Types::String, null: true, description: 'Indicates if syncing is limited to only specific groups, or shards.'
-      field :selective_sync_shards, type: [GraphQL::Types::String], null: true, description: 'The repository storages whose projects should be synced, if `selective_sync_type` == `shards`.'
-      field :selective_sync_namespaces, ::Types::NamespaceType.connection_type, null: true, method: :namespaces, description: 'The namespaces that should be synced, if `selective_sync_type` == `namespaces`.'
-      field :minimum_reverification_interval, GraphQL::Types::Int, null: true, description: 'The interval (in days) in which the repository verification is valid. Once expired, it will be reverified.'
+      field :selective_sync_shards, type: [GraphQL::Types::String], null: true, description: 'Repository storages whose projects should be synced, if `selective_sync_type` == `shards`.'
+      field :selective_sync_namespaces, ::Types::NamespaceType.connection_type, null: true, method: :namespaces, description: 'Namespaces that should be synced, if `selective_sync_type` == `namespaces`.'
+      field :minimum_reverification_interval, GraphQL::Types::Int, null: true, description: 'Interval (in days) in which the repository verification is valid. After expiry, it is reverted.'
       field :merge_request_diff_registries, ::Types::Geo::MergeRequestDiffRegistryType.connection_type,
             null: true,
             resolver: ::Resolvers::Geo::MergeRequestDiffRegistriesResolver,

ee/app/graphql/types/incident_management/escalation_policy_type.rb

@@ -14,11 +14,11 @@ module Types
 
       field :name, GraphQL::Types::String,
             null: true,
-            description: 'The name of the escalation policy.'
+            description: 'Name of the escalation policy.'
 
       field :description, GraphQL::Types::String,
             null: true,
-            description: 'The description of the escalation policy.'
+            description: 'Description of the escalation policy.'
 
       field :rules, [Types::IncidentManagement::EscalationRuleType],
             null: true,

ee/app/graphql/types/incident_management/escalation_rule_input_type.rb

@@ -7,19 +7,19 @@ module Types
       description 'Represents an escalation rule'
 
       argument :oncall_schedule_iid, GraphQL::Types::ID, # rubocop: disable Graphql/IDType
-        description: 'The on-call schedule to notify.',
+        description: 'On-call schedule to notify.',
         required: false
 
       argument :username, GraphQL::Types::String,
-        description: 'The username of the user to notify.',
+        description: 'Username of the user to notify.',
         required: false
 
       argument :elapsed_time_seconds, GraphQL::Types::Int,
-        description: 'The time in seconds before the rule is activated.',
+        description: 'Time in seconds before the rule is activated.',
         required: true
 
       argument :status, Types::IncidentManagement::EscalationRuleStatusEnum,
-        description: 'The status required to prevent the rule from activating.',
+        description: 'Status required to prevent the rule from activating.',
         required: true
 
       def prepare

ee/app/graphql/types/incident_management/escalation_rule_type.rb

@@ -13,19 +13,19 @@ module Types
 
       field :oncall_schedule, Types::IncidentManagement::OncallScheduleType,
             null: true,
-            description: 'The on-call schedule to notify.'
+            description: 'On-call schedule to notify.'
 
       field :user, Types::UserType,
             null: true,
-            description: 'The user to notify.'
+            description: 'User to notify.'
 
       field :elapsed_time_seconds, GraphQL::Types::Int,
             null: true,
-            description: 'The time in seconds before the rule is activated.'
+            description: 'Time in seconds before the rule is activated.'
 
       field :status, Types::IncidentManagement::EscalationRuleStatusEnum,
             null: true,
-            description: 'The status required to prevent the rule from activating.'
+            description: 'Status required to prevent the rule from activating.'
 
       def oncall_schedule
         Gitlab::Graphql::Loaders::BatchModelLoader.new(::IncidentManagement::OncallSchedule, object.oncall_schedule_id).find

ee/app/graphql/types/incident_management/oncall_participant_type.rb

@@ -14,15 +14,15 @@ module Types
 
       field :user, Types::UserType,
                 null: false,
-                description: 'The user who is participating.'
+                description: 'User who is participating.'
 
       field :color_palette, GraphQL::Types::String,
                 null: true,
-                description: 'The color palette to assign to the on-call user. For example "blue".'
+                description: 'Color palette to assign to the on-call user. For example "blue".'
 
       field :color_weight, GraphQL::Types::String,
                 null: true,
-                description: 'The color weight to assign to for the on-call user, for example "500". Max 4 chars. For easy identification of the user.'
+                description: 'Color weight to assign to for the on-call user, for example "500". Max 4 chars. For easy identification of the user.'
     end
     # rubocop: enable Graphql/AuthorizeTypes
   end

ee/app/graphql/types/incident_management/oncall_rotation_active_period_input_type.rb

@@ -9,11 +9,11 @@ module Types
 
       argument :start_time, GraphQL::Types::String,
                 required: true,
-                description: 'The start of the rotation active period in 24 hour format, for example "18:30".'
+                description: 'Start of the rotation active period in 24 hour format. For example, "18:30".'
 
       argument :end_time, GraphQL::Types::String,
                 required: true,
-                description: 'The end of the rotation active period in 24 hour format, for example "18:30".'
+                description: 'End of the rotation active period in 24 hour format. For example, "18:30".'
     end
     # rubocop: enable Graphql/AuthorizeTypes
   end

ee/app/graphql/types/incident_management/oncall_rotation_active_period_type.rb

@@ -9,11 +9,11 @@ module Types
 
       field :start_time, GraphQL::Types::String,
             null: true,
-            description: 'The start of the rotation active period.'
+            description: 'Start of the rotation active period.'
 
       field :end_time, GraphQL::Types::String,
             null: true,
-            description: 'The end of the rotation active period.'
+            description: 'End of the rotation active period.'
 
       alias_method :active_period, :object
 

ee/app/graphql/types/incident_management/oncall_rotation_date_input_type.rb

@@ -8,11 +8,11 @@ module Types
 
       argument :date, GraphQL::Types::String,
                 required: true,
-                description: 'The date component of the date in YYYY-MM-DD format.'
+                description: 'Date component of the date in YYYY-MM-DD format.'
 
       argument :time, GraphQL::Types::String,
                 required: true,
-                description: 'The time component of the date in 24hr HH:MM format.'
+                description: 'Time component of the date in 24hr HH:MM format.'
 
       DATE_FORMAT = %r[^\d{4}-[0123]\d-\d{2}$].freeze
       TIME_FORMAT = %r[^(0\d|1\d|2[0-3]):[0-5]\d$].freeze

ee/app/graphql/types/incident_management/oncall_rotation_length_input_type.rb

@@ -8,11 +8,11 @@ module Types
 
       argument :length, GraphQL::Types::Int,
                 required: true,
-                description: 'The rotation length of the on-call rotation.'
+                description: 'Rotation length of the on-call rotation.'
 
       argument :unit, Types::IncidentManagement::OncallRotationLengthUnitEnum,
                 required: true,
-                description: 'The unit of the rotation length of the on-call rotation.'
+                description: 'Unit of the rotation length of the on-call rotation.'
     end
   end
 end

ee/app/graphql/types/incident_management/oncall_user_input_type.rb

@@ -8,15 +8,15 @@ module Types
 
       argument :username, GraphQL::Types::String,
                 required: true,
-                description: 'The username of the user to participate in the on-call rotation, such as `user_one`.'
+                description: 'Username of the user to participate in the on-call rotation. For example, `"user_one"`.'
 
       argument :color_palette, ::Types::DataVisualizationPalette::ColorEnum,
                 required: false,
-                description: 'A value of DataVisualizationColorEnum. The color from the palette to assign to the on-call user.'
+                description: 'Value of DataVisualizationColorEnum. The color from the palette to assign to the on-call user.'
 
       argument :color_weight, ::Types::DataVisualizationPalette::WeightEnum,
                 required: false,
-                description: 'A value of DataVisualizationWeightEnum. The color weight to assign to for the on-call user. Note: To view on-call schedules in GitLab, do not provide a value below 500. A value between 500 and 950 ensures sufficient contrast.'
+                description: 'Color weight to assign to for the on-call user. To view on-call schedules in GitLab, do not provide a value below 500. A value between 500 and 950 ensures sufficient contrast.'
     end
   end
 end

ee/app/graphql/types/move_type_enum.rb

@@ -5,7 +5,7 @@ module Types
     graphql_name 'MoveType'
     description 'The position to which the adjacent object should be moved'
 
-    value 'before', 'The adjacent object will be moved before the object that is being moved.'
-    value 'after', 'The adjacent object will be moved after the object that is being moved.'
+    value 'before', 'Adjacent object is moved before the object that is being moved.'
+    value 'after', 'Adjacent object is moved after the object that is being moved.'
   end
 end

ee/app/graphql/types/network_policy_kind_enum.rb

@@ -5,7 +5,7 @@ module Types
     graphql_name 'NetworkPolicyKind'
     description 'Kind of the network policy'
 
-    value Gitlab::Kubernetes::CiliumNetworkPolicy::KIND, 'The policy kind of Cilium Network Policy.'
-    value Gitlab::Kubernetes::NetworkPolicy::KIND, 'The policy kind of Network Policy.'
+    value Gitlab::Kubernetes::CiliumNetworkPolicy::KIND, 'Policy kind of Cilium Network Policy.'
+    value Gitlab::Kubernetes::NetworkPolicy::KIND, 'Policy kind of Network Policy.'
   end
 end

ee/app/graphql/types/path_lock_type.rb

@@ -8,9 +8,9 @@ module Types
           description: 'ID of the path lock.'
 
     field :path, GraphQL::Types::String, null: true,
-          description: 'The locked path.'
+          description: 'Locked path.'
 
     field :user, ::Types::UserType, null: true,
-          description: 'The user that has locked this path.'
+          description: 'User that has locked this path.'
   end
 end

ee/app/graphql/types/pipeline_security_report_finding_type.rb

@@ -57,7 +57,7 @@ module Types
     field :project,
           type: ::Types::ProjectType,
           null: true,
-          description: 'The project on which the vulnerability finding was found.'
+          description: 'Project on which the vulnerability finding was found.'
 
     field :description,
           type: GraphQL::Types::String,
@@ -80,7 +80,7 @@ module Types
     field :state,
           type: VulnerabilityStateEnum,
           null: true,
-          description: "The finding status."
+          description: "Finding status."
 
     def location
       object.location&.merge(report_type: object.report_type)

ee/app/graphql/types/scanned_resource_type.rb

@@ -6,7 +6,7 @@ module Types
     graphql_name 'ScannedResource'
     description 'Represents a resource scanned by a security scan'
 
-    field :url, GraphQL::Types::String, null: true, description: 'The URL scanned by the scanner.'
-    field :request_method, GraphQL::Types::String, null: true, description: 'The HTTP request method used to access the URL.'
+    field :url, GraphQL::Types::String, null: true, description: 'URL scanned by the scanner.'
+    field :request_method, GraphQL::Types::String, null: true, description: 'HTTP request method used to access the URL.'
   end
 end

ee/app/graphql/types/security_report_summary_section_type.rb

@@ -8,7 +8,7 @@ module Types
 
     field :vulnerabilities_count, GraphQL::Types::Int, null: true, description: 'Total number of vulnerabilities.'
     field :scanned_resources_count, GraphQL::Types::Int, null: true, description: 'Total number of scanned resources.'
-    field :scanned_resources, ::Types::ScannedResourceType.connection_type, null: true, description: 'A list of the first 20 scanned resources.'
+    field :scanned_resources, ::Types::ScannedResourceType.connection_type, null: true, description: 'List of the first 20 scanned resources.'
     field :scanned_resources_csv_path, GraphQL::Types::String, null: true, description: 'Path to download all the scanned resources in CSV format.'
     field :scans, ::Types::ScanType.connection_type, null: false, description: 'List of security scans ran for the type.'
   end

ee/app/graphql/types/timebox_metrics_type.rb

@@ -7,9 +7,9 @@ module Types
     description 'Represents measured stats metrics for timeboxes'
 
     field :count, GraphQL::Types::Int, null: false,
-          description: 'The count metric.'
+          description: 'Count metric.'
 
     field :weight, GraphQL::Types::Int, null: false,
-          description: 'The weight metric.'
+          description: 'Weight metric.'
   end
 end

ee/app/graphql/types/vulnerability/issue_link_type.rb

@@ -15,7 +15,7 @@ module Types
             description: "Type of the issue link."
 
       field :issue, ::Types::IssueType, null: false,
-            description: 'The issue attached to issue link.'
+            description: 'Issue attached to issue link.'
     end
   end
 end

ee/app/graphql/types/vulnerability_details/commit_type.rb

@@ -8,7 +8,7 @@ module Types
       description 'Represents the vulnerability details commit field'
 
       field :value, GraphQL::Types::String, null: false,
-            description: 'The commit SHA value.'
+            description: 'Commit SHA value.'
     end
   end
 end

ee/app/graphql/types/vulnerability_type.rb

@@ -58,7 +58,7 @@ module Types
           description: 'Identifiers of the vulnerability.'
 
     field :project, ::Types::ProjectType, null: true,
-          description: 'The project on which the vulnerability was found.',
+          description: 'Project on which the vulnerability was found.',
           authorize: :read_project
 
     field :detected_at, Types::TimeType, null: false,
@@ -82,13 +82,13 @@ module Types
           description: 'Merge request that fixes the vulnerability.'
 
     field :confirmed_by, ::Types::UserType, null: true,
-          description: 'The user that confirmed the vulnerability.'
+          description: 'User that confirmed the vulnerability.'
 
     field :resolved_by, ::Types::UserType, null: true,
-          description: 'The user that resolved the vulnerability.'
+          description: 'User that resolved the vulnerability.'
 
     field :dismissed_by, ::Types::UserType, null: true,
-          description: 'The user that dismissed the vulnerability.'
+          description: 'User that dismissed the vulnerability.'
 
     field :details, [VulnerabilityDetailType], null: false,
           description: 'Details of the vulnerability.',

ee/app/graphql/types/vulnerable_dependency_type.rb

@@ -7,9 +7,9 @@ module Types
     description 'Represents a vulnerable dependency. Used in vulnerability location data'
 
     field :package, ::Types::VulnerablePackageType, null: true,
-          description: 'The package associated with the vulnerable dependency.'
+          description: 'Package associated with the vulnerable dependency.'
 
     field :version, GraphQL::Types::String, null: true,
-          description: 'The version of the vulnerable dependency.'
+          description: 'Version of the vulnerable dependency.'
   end
 end

ee/app/graphql/types/vulnerable_package_type.rb

@@ -7,6 +7,6 @@ module Types
     description 'Represents a vulnerable package. Used in vulnerability dependency data'
 
     field :name, GraphQL::Types::String, null: true,
-          description: 'The name of the vulnerable package.'
+          description: 'Name of the vulnerable package.'
   end
 end