Merge branch '299489-over-10-of-graphql-descriptions-are-missing-snippet-visibility' into 'master'

Add descriptions to Snippets::VisibilityScopesEnum

See merge request gitlab-org/gitlab!61825

.rubocop_manual_todo.yml

@@ -14,7 +14,6 @@
 Graphql/Descriptions:
   Exclude:
     - 'app/graphql/types/snippets/blob_action_enum.rb'
-    - 'app/graphql/types/snippets/visibility_scopes_enum.rb'
     - 'ee/app/graphql/ee/types/list_limit_metric_enum.rb'
     - 'ee/app/graphql/types/epic_state_enum.rb'
     - 'ee/app/graphql/types/health_status_enum.rb'

app/graphql/types/snippets/visibility_scopes_enum.rb

@@ -3,9 +3,9 @@
 module Types
   module Snippets
     class VisibilityScopesEnum < BaseEnum
-      value 'private',  value: 'are_private'
-      value 'internal', value: 'are_internal'
-      value 'public',   value: 'are_public'
+      value 'private', description: 'The snippet is visible only to the snippet creator.', value: 'are_private'
+      value 'internal', description: 'The snippet is visible for any logged in user except external users.', value: 'are_internal'
+      value 'public', description: 'The snippet can be accessed without any authentication.', value: 'are_public'
     end
   end
 end

doc/api/graphql/reference/index.md

@@ -14668,9 +14668,9 @@ Possible states of a user.
 
 | Value | Description |
 | ----- | ----------- |
-| <a id="visibilityscopesenuminternal"></a>`internal` |  |
-| <a id="visibilityscopesenumprivate"></a>`private` |  |
-| <a id="visibilityscopesenumpublic"></a>`public` |  |
+| <a id="visibilityscopesenuminternal"></a>`internal` | The snippet is visible for any logged in user except external users. |
+| <a id="visibilityscopesenumprivate"></a>`private` | The snippet is visible only to the snippet creator. |
+| <a id="visibilityscopesenumpublic"></a>`public` | The snippet can be accessed without any authentication. |
 
 ### `VulnerabilityDismissalReason`
 

doc/api/project_snippets.md

@@ -16,7 +16,7 @@ Constants for snippet visibility levels are:
 
 | visibility | Description |
 | ---------- | ----------- |
-| `private`  | The snippet is visible only the snippet creator |
+| `private`  | The snippet is visible only to the snippet creator |
 | `internal` | The snippet is visible for any logged in user except [external users](../user/permissions.md#external-users) |
 | `public`   | The snippet can be accessed without any authentication |