Merge branch '322903-fix-graphql-descriptions-1' into 'master'

Autocorrect Graphql/Descriptions offenses

See merge request gitlab-org/gitlab!55430

.rubocop_manual_todo.yml

@@ -14,59 +14,24 @@
 Graphql/Descriptions:
   Exclude:
     - 'app/graphql/types/access_level_enum.rb'
-    - 'app/graphql/types/admin/analytics/usage_trends/measurement_identifier_enum.rb'
-    - 'app/graphql/types/alert_management/alert_sort_enum.rb'
-    - 'app/graphql/types/alert_management/domain_filter_enum.rb'
-    - 'app/graphql/types/alert_management/integration_type_enum.rb'
     - 'app/graphql/types/base_enum.rb'
-    - 'app/graphql/types/ci/config/status_enum.rb'
-    - 'app/graphql/types/ci/job_artifact_file_type_enum.rb'
     - 'app/graphql/types/ci/pipeline_config_source_enum.rb'
     - 'app/graphql/types/ci/pipeline_status_enum.rb'
-    - 'app/graphql/types/commit_action_mode_enum.rb'
-    - 'app/graphql/types/commit_encoding_enum.rb'
     - 'app/graphql/types/container_expiration_policy_cadence_enum.rb'
     - 'app/graphql/types/container_expiration_policy_keep_enum.rb'
     - 'app/graphql/types/container_expiration_policy_older_than_enum.rb'
-    - 'app/graphql/types/container_repository_sort_enum.rb'
-    - 'app/graphql/types/design_management/design_version_event_enum.rb'
-    - 'app/graphql/types/error_tracking/sentry_error_status_enum.rb'
-    - 'app/graphql/types/issuable_sort_enum.rb'
-    - 'app/graphql/types/issuable_state_enum.rb'
-    - 'app/graphql/types/issue_sort_enum.rb'
-    - 'app/graphql/types/issue_state_event_enum.rb'
-    - 'app/graphql/types/merge_request_sort_enum.rb'
-    - 'app/graphql/types/merge_request_state_enum.rb'
-    - 'app/graphql/types/milestone_state_enum.rb'
-    - 'app/graphql/types/mutation_operation_mode_enum.rb'
     - 'app/graphql/types/notes/position_type_enum.rb'
     - 'app/graphql/types/packages/package_type_enum.rb'
-    - 'app/graphql/types/projects/namespace_project_sort_enum.rb'
-    - 'app/graphql/types/release_sort_enum.rb'
     - 'app/graphql/types/snippets/blob_action_enum.rb'
     - 'app/graphql/types/snippets/type_enum.rb'
     - 'app/graphql/types/snippets/visibility_scopes_enum.rb'
-    - 'app/graphql/types/sort_enum.rb'
     - 'app/graphql/types/todo_action_enum.rb'
-    - 'app/graphql/types/todo_target_enum.rb'
     - 'app/graphql/types/tree/type_enum.rb'
-    - 'app/graphql/types/user_state_enum.rb'
-    - 'ee/app/graphql/ee/types/issue_sort_enum.rb'
     - 'ee/app/graphql/ee/types/list_limit_metric_enum.rb'
-    - 'ee/app/graphql/ee/types/todo_target_enum.rb'
     - 'ee/app/graphql/types/alert_management/payload_alert_field_name_enum.rb'
-    - 'ee/app/graphql/types/alert_management/payload_alert_field_type_enum.rb'
-    - 'ee/app/graphql/types/boards/epic_wildcard_id_enum.rb'
-    - 'ee/app/graphql/types/boards/iteration_wildcard_id_enum.rb'
-    - 'ee/app/graphql/types/dast_site_profile_validation_status_enum.rb'
-    - 'ee/app/graphql/types/dast_site_validation_strategy_enum.rb'
-    - 'ee/app/graphql/types/epic_sort_enum.rb'
     - 'ee/app/graphql/types/epic_state_enum.rb'
-    - 'ee/app/graphql/types/epic_state_event_enum.rb'
-    - 'ee/app/graphql/types/geo/registry_state_enum.rb'
     - 'ee/app/graphql/types/health_status_enum.rb'
     - 'ee/app/graphql/types/iteration_state_enum.rb'
-    - 'ee/app/graphql/types/move_type_enum.rb'
     - 'ee/app/graphql/types/requirements_management/requirement_state_enum.rb'
     - 'ee/app/graphql/types/requirements_management/test_report_state_enum.rb'
     - 'ee/app/graphql/types/security_scanner_type_enum.rb'
@@ -74,7 +39,6 @@ Graphql/Descriptions:
     - 'ee/app/graphql/types/vulnerability_grade_enum.rb'
     - 'ee/app/graphql/types/vulnerability_report_type_enum.rb'
     - 'ee/app/graphql/types/vulnerability_severity_enum.rb'
-    - 'ee/app/graphql/types/vulnerability_sort_enum.rb'
     - 'ee/app/graphql/types/vulnerability_state_enum.rb'
 
 # WIP See https://gitlab.com/gitlab-org/gitlab/-/issues/267606

app/graphql/types/admin/analytics/usage_trends/measurement_identifier_enum.rb

@@ -8,16 +8,16 @@ module Types
           graphql_name 'MeasurementIdentifier'
           description 'Possible identifier types for a measurement'
 
-          value 'PROJECTS', 'Project count', value: 'projects'
-          value 'USERS', 'User count', value: 'users'
-          value 'ISSUES', 'Issue count', value: 'issues'
-          value 'MERGE_REQUESTS', 'Merge request count', value: 'merge_requests'
-          value 'GROUPS', 'Group count', value: 'groups'
-          value 'PIPELINES', 'Pipeline count', value: 'pipelines'
-          value 'PIPELINES_SUCCEEDED', 'Pipeline count with success status', value: 'pipelines_succeeded'
-          value 'PIPELINES_FAILED', 'Pipeline count with failed status', value: 'pipelines_failed'
-          value 'PIPELINES_CANCELED', 'Pipeline count with canceled status', value: 'pipelines_canceled'
-          value 'PIPELINES_SKIPPED', 'Pipeline count with skipped status', value: 'pipelines_skipped'
+          value 'PROJECTS', 'Project count.', value: 'projects'
+          value 'USERS', 'User count.', value: 'users'
+          value 'ISSUES', 'Issue count.', value: 'issues'
+          value 'MERGE_REQUESTS', 'Merge request count.', value: 'merge_requests'
+          value 'GROUPS', 'Group count.', value: 'groups'
+          value 'PIPELINES', 'Pipeline count.', value: 'pipelines'
+          value 'PIPELINES_SUCCEEDED', 'Pipeline count with success status.', value: 'pipelines_succeeded'
+          value 'PIPELINES_FAILED', 'Pipeline count with failed status.', value: 'pipelines_failed'
+          value 'PIPELINES_CANCELED', 'Pipeline count with canceled status.', value: 'pipelines_canceled'
+          value 'PIPELINES_SKIPPED', 'Pipeline count with skipped status.', value: 'pipelines_skipped'
         end
       end
     end

app/graphql/types/alert_management/alert_sort_enum.rb

@@ -6,20 +6,20 @@ module Types
       graphql_name 'AlertManagementAlertSort'
       description 'Values for sorting alerts'
 
-      value 'STARTED_AT_ASC', 'Start time by ascending order', value: :started_at_asc
-      value 'STARTED_AT_DESC', 'Start time by descending order', value: :started_at_desc
-      value 'ENDED_AT_ASC', 'End time by ascending order', value: :ended_at_asc
-      value 'ENDED_AT_DESC', 'End time by descending order', value: :ended_at_desc
-      value 'CREATED_TIME_ASC', 'Created time by ascending order', value: :created_at_asc
-      value 'CREATED_TIME_DESC', 'Created time by descending order', value: :created_at_desc
-      value 'UPDATED_TIME_ASC', 'Created time by ascending order', value: :updated_at_asc
-      value 'UPDATED_TIME_DESC', 'Created time by descending order', value: :updated_at_desc
-      value 'EVENT_COUNT_ASC', 'Events count by ascending order', value: :event_count_asc
-      value 'EVENT_COUNT_DESC', 'Events count by descending order', value: :event_count_desc
-      value 'SEVERITY_ASC', 'Severity from less critical to more critical', value: :severity_asc
-      value 'SEVERITY_DESC', 'Severity from more critical to less critical', value: :severity_desc
-      value 'STATUS_ASC', 'Status by order: Ignored > Resolved > Acknowledged > Triggered', value: :status_asc
-      value 'STATUS_DESC', 'Status by order: Triggered > Acknowledged > Resolved > Ignored', value: :status_desc
+      value 'STARTED_AT_ASC', 'Start time by ascending order.', value: :started_at_asc
+      value 'STARTED_AT_DESC', 'Start time by descending order.', value: :started_at_desc
+      value 'ENDED_AT_ASC', 'End time by ascending order.', value: :ended_at_asc
+      value 'ENDED_AT_DESC', 'End time by descending order.', value: :ended_at_desc
+      value 'CREATED_TIME_ASC', 'Created time by ascending order.', value: :created_at_asc
+      value 'CREATED_TIME_DESC', 'Created time by descending order.', value: :created_at_desc
+      value 'UPDATED_TIME_ASC', 'Created time by ascending order.', value: :updated_at_asc
+      value 'UPDATED_TIME_DESC', 'Created time by descending order.', value: :updated_at_desc
+      value 'EVENT_COUNT_ASC', 'Events count by ascending order.', value: :event_count_asc
+      value 'EVENT_COUNT_DESC', 'Events count by descending order.', value: :event_count_desc
+      value 'SEVERITY_ASC', 'Severity from less critical to more critical.', value: :severity_asc
+      value 'SEVERITY_DESC', 'Severity from more critical to less critical.', value: :severity_desc
+      value 'STATUS_ASC', 'Status by order: Ignored > Resolved > Acknowledged > Triggered.', value: :status_asc
+      value 'STATUS_DESC', 'Status by order: Triggered > Acknowledged > Resolved > Ignored.', value: :status_desc
     end
   end
 end

app/graphql/types/alert_management/domain_filter_enum.rb

@@ -6,8 +6,8 @@ module Types
       graphql_name 'AlertManagementDomainFilter'
       description  'Filters the alerts based on given domain'
 
-      value 'operations', description: 'Alerts for operations domain'
-      value 'threat_monitoring', description: 'Alerts for threat monitoring domain'
+      value 'operations', description: 'Alerts for operations domain.'
+      value 'threat_monitoring', description: 'Alerts for threat monitoring domain.'
     end
   end
 end

app/graphql/types/alert_management/integration_type_enum.rb

@@ -6,8 +6,8 @@ module Types
       graphql_name 'AlertManagementIntegrationType'
       description 'Values of types of integrations'
 
-      value 'PROMETHEUS', 'Prometheus integration', value: :prometheus
-      value 'HTTP', 'Integration with any monitoring tool', value: :http
+      value 'PROMETHEUS', 'Prometheus integration.', value: :prometheus
+      value 'HTTP', 'Integration with any monitoring tool.', value: :http
     end
   end
 end

app/graphql/types/ci/config/status_enum.rb

@@ -7,8 +7,8 @@ module Types
         graphql_name 'CiConfigStatus'
         description 'Values for YAML processor result'
 
-        value 'VALID', 'The configuration file is valid', value: :valid
-        value 'INVALID', 'The configuration file is not valid', value: :invalid
+        value 'VALID', 'The configuration file is valid.', value: :valid
+        value 'INVALID', 'The configuration file is not valid.', value: :invalid
       end
     end
   end

app/graphql/types/commit_action_mode_enum.rb

@@ -5,10 +5,10 @@ module Types
     graphql_name 'CommitActionMode'
     description 'Mode of a commit action'
 
-    value 'CREATE', description: 'Create command', value: :create
-    value 'DELETE', description: 'Delete command', value: :delete
-    value 'MOVE', description: 'Move command', value: :move
-    value 'UPDATE', description: 'Update command', value: :update
-    value 'CHMOD', description: 'Chmod command', value: :chmod
+    value 'CREATE', description: 'Create command.', value: :create
+    value 'DELETE', description: 'Delete command.', value: :delete
+    value 'MOVE', description: 'Move command.', value: :move
+    value 'UPDATE', description: 'Update command.', value: :update
+    value 'CHMOD', description: 'Chmod command.', value: :chmod
   end
 end

app/graphql/types/commit_encoding_enum.rb

@@ -4,7 +4,7 @@ module Types
   class CommitEncodingEnum < BaseEnum
     graphql_name 'CommitEncoding'
 
-    value 'TEXT', description: 'Text encoding', value: :text
-    value 'BASE64', description: 'Base64 encoding', value: :base64
+    value 'TEXT', description: 'Text encoding.', value: :text
+    value 'BASE64', description: 'Base64 encoding.', value: :base64
   end
 end

app/graphql/types/container_repository_sort_enum.rb

@@ -5,7 +5,7 @@ module Types
     graphql_name 'ContainerRepositorySort'
     description 'Values for sorting container repositories'
 
-    value 'NAME_ASC', 'Name by ascending order', value: :name_asc
-    value 'NAME_DESC', 'Name by descending order', value: :name_desc
+    value 'NAME_ASC', 'Name by ascending order.', value: :name_asc
+    value 'NAME_DESC', 'Name by descending order.', value: :name_desc
   end
 end

app/graphql/types/design_management/design_version_event_enum.rb

@@ -8,7 +8,7 @@ module Types
 
       NONE = 'NONE'
 
-      value NONE, 'No change'
+      value NONE, 'No change.'
 
       ::DesignManagement::Action.events.keys.each do |event_name|
         value event_name.upcase, value: event_name, description: "A #{event_name} event"

app/graphql/types/error_tracking/sentry_error_status_enum.rb

@@ -6,10 +6,10 @@ module Types
       graphql_name 'SentryErrorStatus'
       description 'State of a Sentry error'
 
-      value 'RESOLVED', value: 'resolved', description: 'Error has been resolved'
-      value 'RESOLVED_IN_NEXT_RELEASE', value: 'resolvedInNextRelease', description: 'Error has been ignored until next release'
-      value 'UNRESOLVED', value: 'unresolved', description: 'Error is unresolved'
-      value 'IGNORED', value: 'ignored', description: 'Error has been ignored'
+      value 'RESOLVED', value: 'resolved', description: 'Error has been resolved.'
+      value 'RESOLVED_IN_NEXT_RELEASE', value: 'resolvedInNextRelease', description: 'Error has been ignored until next release.'
+      value 'UNRESOLVED', value: 'unresolved', description: 'Error is unresolved.'
+      value 'IGNORED', value: 'ignored', description: 'Error has been ignored.'
     end
   end
 end

app/graphql/types/issuable_sort_enum.rb

@@ -5,11 +5,11 @@ module Types
     graphql_name 'IssuableSort'
     description 'Values for sorting issuables'
 
-    value 'PRIORITY_ASC', 'Priority by ascending order', value: :priority_asc
-    value 'PRIORITY_DESC', 'Priority by descending order', value: :priority_desc
-    value 'LABEL_PRIORITY_ASC', 'Label priority by ascending order', value: :label_priority_asc
-    value 'LABEL_PRIORITY_DESC', 'Label priority by descending order', value: :label_priority_desc
-    value 'MILESTONE_DUE_ASC', 'Milestone due date by ascending order', value: :milestone_due_asc
-    value 'MILESTONE_DUE_DESC', 'Milestone due date by descending order', value: :milestone_due_desc
+    value 'PRIORITY_ASC', 'Priority by ascending order.', value: :priority_asc
+    value 'PRIORITY_DESC', 'Priority by descending order.', value: :priority_desc
+    value 'LABEL_PRIORITY_ASC', 'Label priority by ascending order.', value: :label_priority_asc
+    value 'LABEL_PRIORITY_DESC', 'Label priority by descending order.', value: :label_priority_desc
+    value 'MILESTONE_DUE_ASC', 'Milestone due date by ascending order.', value: :milestone_due_asc
+    value 'MILESTONE_DUE_DESC', 'Milestone due date by descending order.', value: :milestone_due_desc
   end
 end

app/graphql/types/issuable_state_enum.rb

@@ -5,9 +5,9 @@ module Types
     graphql_name 'IssuableState'
     description 'State of a GitLab issue or merge request'
 
-    value 'opened', description: 'In open state'
-    value 'closed', description: 'In closed state'
-    value 'locked', description: 'Discussion has been locked'
-    value 'all', description: 'All available'
+    value 'opened', description: 'In open state.'
+    value 'closed', description: 'In closed state.'
+    value 'locked', description: 'Discussion has been locked.'
+    value 'all', description: 'All available.'
   end
 end

app/graphql/types/issue_sort_enum.rb

@@ -5,11 +5,11 @@ module Types
     graphql_name 'IssueSort'
     description 'Values for sorting issues'
 
-    value 'DUE_DATE_ASC', 'Due date by ascending order', value: :due_date_asc
-    value 'DUE_DATE_DESC', 'Due date by descending order', value: :due_date_desc
-    value 'RELATIVE_POSITION_ASC', 'Relative position by ascending order', value: :relative_position_asc
-    value 'SEVERITY_ASC', 'Severity from less critical to more critical', value: :severity_asc
-    value 'SEVERITY_DESC', 'Severity from more critical to less critical', value: :severity_desc
+    value 'DUE_DATE_ASC', 'Due date by ascending order.', value: :due_date_asc
+    value 'DUE_DATE_DESC', 'Due date by descending order.', value: :due_date_desc
+    value 'RELATIVE_POSITION_ASC', 'Relative position by ascending order.', value: :relative_position_asc
+    value 'SEVERITY_ASC', 'Severity from less critical to more critical.', value: :severity_asc
+    value 'SEVERITY_DESC', 'Severity from more critical to less critical.', value: :severity_desc
   end
 end
 

app/graphql/types/issue_state_event_enum.rb

@@ -5,7 +5,7 @@ module Types
     graphql_name 'IssueStateEvent'
     description 'Values for issue state events'
 
-    value 'REOPEN', 'Reopens the issue', value: 'reopen'
-    value 'CLOSE', 'Closes the issue', value: 'close'
+    value 'REOPEN', 'Reopens the issue.', value: 'reopen'
+    value 'CLOSE', 'Closes the issue.', value: 'close'
   end
 end

app/graphql/types/merge_request_sort_enum.rb

@@ -5,7 +5,7 @@ module Types
     graphql_name 'MergeRequestSort'
     description 'Values for sorting merge requests'
 
-    value 'MERGED_AT_ASC', 'Merge time by ascending order', value: :merged_at_asc
-    value 'MERGED_AT_DESC', 'Merge time by descending order', value: :merged_at_desc
+    value 'MERGED_AT_ASC', 'Merge time by ascending order.', value: :merged_at_asc
+    value 'MERGED_AT_DESC', 'Merge time by descending order.', value: :merged_at_desc
   end
 end

app/graphql/types/merge_request_state_enum.rb

@@ -5,6 +5,6 @@ module Types
     graphql_name 'MergeRequestState'
     description 'State of a GitLab merge request'
 
-    value 'merged', description: "Merge Request has been merged"
+    value 'merged', description: "Merge Request has been merged."
   end
 end

app/graphql/types/milestone_state_enum.rb

@@ -5,7 +5,7 @@ module Types
     graphql_name 'MilestoneStateEnum'
     description 'Current state of milestone'
 
-    value 'active', description: 'Milestone is currently active'
-    value 'closed', description: 'Milestone is closed'
+    value 'active', description: 'Milestone is currently active.'
+    value 'closed', description: 'Milestone is closed.'
   end
 end

app/graphql/types/mutation_operation_mode_enum.rb

@@ -7,8 +7,8 @@ module Types
 
     # Suggested param name for the enum: `operation_mode`
 
-    value 'REPLACE', 'Performs a replace operation'
-    value 'APPEND', 'Performs an append operation'
-    value 'REMOVE', 'Performs a removal operation'
+    value 'REPLACE', 'Performs a replace operation.'
+    value 'APPEND', 'Performs an append operation.'
+    value 'REMOVE', 'Performs a removal operation.'
   end
 end

app/graphql/types/projects/namespace_project_sort_enum.rb

@@ -6,8 +6,8 @@ module Types
       graphql_name 'NamespaceProjectSort'
       description 'Values for sorting projects'
 
-      value 'SIMILARITY', 'Most similar to the search query', value: :similarity
-      value 'STORAGE', 'Sort by storage size', value: :storage
+      value 'SIMILARITY', 'Most similar to the search query.', value: :similarity
+      value 'STORAGE', 'Sort by storage size.', value: :storage
     end
   end
 end

app/graphql/types/release_sort_enum.rb

@@ -9,10 +9,10 @@ module Types
 
     # Borrowed from Types::SortEnum
     # These values/descriptions should stay in-sync as much as possible.
-    value 'CREATED_DESC', 'Created at descending order', value: :created_desc
-    value 'CREATED_ASC', 'Created at ascending order', value: :created_asc
+    value 'CREATED_DESC', 'Created at descending order.', value: :created_desc
+    value 'CREATED_ASC', 'Created at ascending order.', value: :created_asc
 
-    value 'RELEASED_AT_DESC', 'Released at by descending order', value: :released_at_desc
-    value 'RELEASED_AT_ASC', 'Released at by ascending order', value: :released_at_asc
+    value 'RELEASED_AT_DESC', 'Released at by descending order.', value: :released_at_desc
+    value 'RELEASED_AT_ASC', 'Released at by ascending order.', value: :released_at_asc
   end
 end

app/graphql/types/sort_enum.rb

@@ -7,14 +7,14 @@ module Types
 
     # Deprecated, as we prefer uppercase enums
     # https://gitlab.com/groups/gitlab-org/-/epics/1838
-    value 'updated_desc', 'Updated at descending order', value: :updated_desc, deprecated: { reason: 'Use UPDATED_DESC', milestone: '13.5' }
-    value 'updated_asc', 'Updated at ascending order', value: :updated_asc, deprecated: { reason: 'Use UPDATED_ASC', milestone: '13.5' }
-    value 'created_desc', 'Created at descending order', value: :created_desc, deprecated: { reason: 'Use CREATED_DESC', milestone: '13.5' }
-    value 'created_asc', 'Created at ascending order', value: :created_asc, deprecated: { reason: 'Use CREATED_ASC', milestone: '13.5' }
+    value 'updated_desc', 'Updated at descending order.', value: :updated_desc, deprecated: { reason: 'Use UPDATED_DESC', milestone: '13.5' }
+    value 'updated_asc', 'Updated at ascending order.', value: :updated_asc, deprecated: { reason: 'Use UPDATED_ASC', milestone: '13.5' }
+    value 'created_desc', 'Created at descending order.', value: :created_desc, deprecated: { reason: 'Use CREATED_DESC', milestone: '13.5' }
+    value 'created_asc', 'Created at ascending order.', value: :created_asc, deprecated: { reason: 'Use CREATED_ASC', milestone: '13.5' }
 
-    value 'UPDATED_DESC', 'Updated at descending order', value: :updated_desc
-    value 'UPDATED_ASC', 'Updated at ascending order', value: :updated_asc
-    value 'CREATED_DESC', 'Created at descending order', value: :created_desc
-    value 'CREATED_ASC', 'Created at ascending order', value: :created_asc
+    value 'UPDATED_DESC', 'Updated at descending order.', value: :updated_desc
+    value 'UPDATED_ASC', 'Updated at ascending order.', value: :updated_asc
+    value 'CREATED_DESC', 'Created at descending order.', value: :created_desc
+    value 'CREATED_ASC', 'Created at ascending order.', value: :created_asc
   end
 end

app/graphql/types/todo_target_enum.rb

@@ -2,11 +2,11 @@
 
 module Types
   class TodoTargetEnum < BaseEnum
-    value 'COMMIT', value: 'Commit', description: 'A Commit'
-    value 'ISSUE', value: 'Issue', description: 'An Issue'
-    value 'MERGEREQUEST', value: 'MergeRequest', description: 'A MergeRequest'
-    value 'DESIGN', value: 'DesignManagement::Design', description: 'A Design'
-    value 'ALERT', value: 'AlertManagement::Alert', description: 'An Alert'
+    value 'COMMIT', value: 'Commit', description: 'A Commit.'
+    value 'ISSUE', value: 'Issue', description: 'An Issue.'
+    value 'MERGEREQUEST', value: 'MergeRequest', description: 'A MergeRequest.'
+    value 'DESIGN', value: 'DesignManagement::Design', description: 'A Design.'
+    value 'ALERT', value: 'AlertManagement::Alert', description: 'An Alert.'
   end
 end
 

app/graphql/types/user_state_enum.rb

@@ -5,8 +5,8 @@ module Types
     graphql_name 'UserState'
     description 'Possible states of a user'
 
-    value 'active', 'The user is active and is able to use the system', value: 'active'
-    value 'blocked', 'The user has been blocked and is prevented from using the system', value: 'blocked'
-    value 'deactivated', 'The user is no longer active and is unable to use the system', value: 'deactivated'
+    value 'active', 'The user is active and is able to use the system.', value: 'active'
+    value 'blocked', 'The user has been blocked and is prevented from using the system.', value: 'blocked'
+    value 'deactivated', 'The user is no longer active and is unable to use the system.', value: 'deactivated'
   end
 end

ee/app/graphql/ee/types/issue_sort_enum.rb

@@ -6,12 +6,12 @@ module EE
       extend ActiveSupport::Concern
 
       prepended do
-        value 'WEIGHT_ASC', 'Weight by ascending order', value: 'weight_asc'
-        value 'WEIGHT_DESC', 'Weight by descending order', value: 'weight_desc'
-        value 'PUBLISHED_ASC', 'Published issues shown last', value: :published_asc
-        value 'PUBLISHED_DESC', 'Published issues shown first', value: :published_desc
-        value 'SLA_DUE_AT_ASC', 'Issues with earliest SLA due time shown first', value: :sla_due_at_asc
-        value 'SLA_DUE_AT_DESC', 'Issues with latest SLA due time shown first', value: :sla_due_at_desc
+        value 'WEIGHT_ASC', 'Weight by ascending order.', value: 'weight_asc'
+        value 'WEIGHT_DESC', 'Weight by descending order.', value: 'weight_desc'
+        value 'PUBLISHED_ASC', 'Published issues shown last.', value: :published_asc
+        value 'PUBLISHED_DESC', 'Published issues shown first.', value: :published_desc
+        value 'SLA_DUE_AT_ASC', 'Issues with earliest SLA due time shown first.', value: :sla_due_at_asc
+        value 'SLA_DUE_AT_DESC', 'Issues with latest SLA due time shown first.', value: :sla_due_at_desc
       end
     end
   end

ee/app/graphql/ee/types/todo_target_enum.rb

@@ -6,7 +6,7 @@ module EE
       extend ActiveSupport::Concern
 
       prepended do
-        value 'EPIC', value: 'Epic', description: 'An Epic'
+        value 'EPIC', value: 'Epic', description: 'An Epic.'
       end
     end
   end

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

@@ -6,9 +6,9 @@ module Types
       graphql_name 'AlertManagementPayloadAlertFieldType'
       description 'Values for alert field types used in the custom mapping'
 
-      value 'ARRAY', 'Array field type', value: 'array'
-      value 'DATETIME', 'DateTime field type', value: 'datetime'
-      value 'STRING', 'String field type', value: 'string'
+      value 'ARRAY', 'Array field type.', value: 'array'
+      value 'DATETIME', 'DateTime field type.', value: 'datetime'
+      value 'STRING', 'String field type.', value: 'string'
     end
   end
 end

ee/app/graphql/types/boards/epic_wildcard_id_enum.rb

@@ -6,8 +6,8 @@ module Types
       graphql_name 'EpicWildcardId'
       description 'Epic ID wildcard values'
 
-      value 'NONE', 'No epic is assigned'
-      value 'ANY', 'Any epic is assigned'
+      value 'NONE', 'No epic is assigned.'
+      value 'ANY', 'Any epic is assigned.'
     end
   end
 end

ee/app/graphql/types/boards/iteration_wildcard_id_enum.rb

@@ -6,9 +6,9 @@ module Types
       graphql_name 'IterationWildcardId'
       description 'Iteration ID wildcard values'
 
-      value 'NONE', 'No iteration is assigned'
-      value 'ANY', 'An iteration is assigned'
-      value 'CURRENT', 'Current iteration'
+      value 'NONE', 'No iteration is assigned.'
+      value 'ANY', 'An iteration is assigned.'
+      value 'CURRENT', 'Current iteration.'
     end
   end
 end

ee/app/graphql/types/dast_site_profile_validation_status_enum.rb

@@ -2,10 +2,10 @@
 
 module Types
   class DastSiteProfileValidationStatusEnum < BaseEnum
-    value 'NONE', value: DastSiteValidation::NONE_STATE, description: 'No site validation exists'
-    value 'PENDING_VALIDATION', value: 'pending', description: 'Site validation process has not started'
-    value 'INPROGRESS_VALIDATION', value: 'inprogress', description: 'Site validation process is in progress'
-    value 'PASSED_VALIDATION', value: 'passed', description: 'Site validation process finished successfully'
-    value 'FAILED_VALIDATION', value: 'failed', description: 'Site validation process finished but failed'
+    value 'NONE', value: DastSiteValidation::NONE_STATE, description: 'No site validation exists.'
+    value 'PENDING_VALIDATION', value: 'pending', description: 'Site validation process has not started.'
+    value 'INPROGRESS_VALIDATION', value: 'inprogress', description: 'Site validation process is in progress.'
+    value 'PASSED_VALIDATION', value: 'passed', description: 'Site validation process finished successfully.'
+    value 'FAILED_VALIDATION', value: 'failed', description: 'Site validation process finished but failed.'
   end
 end

ee/app/graphql/types/dast_site_validation_strategy_enum.rb

@@ -2,7 +2,7 @@
 
 module Types
   class DastSiteValidationStrategyEnum < BaseEnum
-    value 'TEXT_FILE', description: 'Text file validation', value: 'text_file'
-    value 'HEADER', description: 'Header validation', value: 'header'
+    value 'TEXT_FILE', description: 'Text file validation.', value: 'text_file'
+    value 'HEADER', description: 'Header validation.', value: 'header'
   end
 end

ee/app/graphql/types/epic_sort_enum.rb

@@ -5,9 +5,9 @@ module Types
     graphql_name 'EpicSort'
     description 'Roadmap sort values'
 
-    value 'start_date_desc', 'Start date at descending order'
-    value 'start_date_asc', 'Start date at ascending order'
-    value 'end_date_desc', 'End date at descending order'
-    value 'end_date_asc', 'End date at ascending order'
+    value 'start_date_desc', 'Start date at descending order.'
+    value 'start_date_asc', 'Start date at ascending order.'
+    value 'end_date_desc', 'End date at descending order.'
+    value 'end_date_asc', 'End date at ascending order.'
   end
 end

ee/app/graphql/types/epic_state_event_enum.rb

@@ -5,7 +5,7 @@ module Types
     graphql_name 'EpicStateEvent'
     description 'State event of an epic'
 
-    value 'REOPEN', value: 'reopen', description: 'Reopen the epic'
-    value 'CLOSE', value: 'close', description: 'Close the epic'
+    value 'REOPEN', value: 'reopen', description: 'Reopen the epic.'
+    value 'CLOSE', value: 'close', description: 'Close the epic.'
   end
 end

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

@@ -6,10 +6,10 @@ module Types
       graphql_name 'RegistryState'
       description 'State of a Geo registry'
 
-      value 'PENDING', value: :pending, description: 'Registry waiting to be synced'
-      value 'STARTED', value: :started, description: 'Registry currently syncing'
-      value 'SYNCED', value: :synced, description: 'Registry that is synced'
-      value 'FAILED', value: :failed, description: 'Registry that failed to sync'
+      value 'PENDING', value: :pending, description: 'Registry waiting to be synced.'
+      value 'STARTED', value: :started, description: 'Registry currently syncing.'
+      value 'SYNCED', value: :synced, description: 'Registry that is synced.'
+      value 'FAILED', value: :failed, description: 'Registry that failed to sync.'
     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', '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.'
   end
 end

ee/app/graphql/types/vulnerability_sort_enum.rb

@@ -5,15 +5,15 @@ module Types
     graphql_name 'VulnerabilitySort'
     description 'Vulnerability sort values'
 
-    value 'severity_desc', 'Severity in descending order'
-    value 'severity_asc', 'Severity in ascending order'
-    value 'title_desc', 'Title in descending order'
-    value 'title_asc', 'Title in ascending order'
-    value 'detected_desc', 'Detection timestamp in descending order'
-    value 'detected_asc', 'Detection timestamp in ascending order'
-    value 'report_type_desc', 'Report Type in descending order'
-    value 'report_type_asc', 'Report Type in ascending order'
-    value 'state_desc', 'State in descending order'
-    value 'state_asc', 'State in ascending order'
+    value 'severity_desc', 'Severity in descending order.'
+    value 'severity_asc', 'Severity in ascending order.'
+    value 'title_desc', 'Title in descending order.'
+    value 'title_asc', 'Title in ascending order.'
+    value 'detected_desc', 'Detection timestamp in descending order.'
+    value 'detected_asc', 'Detection timestamp in ascending order.'
+    value 'report_type_desc', 'Report Type in descending order.'
+    value 'report_type_asc', 'Report Type in ascending order.'
+    value 'state_desc', 'State in descending order.'
+    value 'state_asc', 'State in ascending order.'
   end
 end