Add descriptions for AccessLevelEnum

app/graphql/types/access_level_enum.rb

@@ -5,11 +5,11 @@ module Types
     graphql_name 'AccessLevelEnum'
     description 'Access level to a resource'
 
-    value 'NO_ACCESS', value: Gitlab::Access::NO_ACCESS
-    value 'GUEST', value: Gitlab::Access::GUEST
-    value 'REPORTER', value: Gitlab::Access::REPORTER
-    value 'DEVELOPER', value: Gitlab::Access::DEVELOPER
-    value 'MAINTAINER', value: Gitlab::Access::MAINTAINER
-    value 'OWNER', value: Gitlab::Access::OWNER
+    value 'NO_ACCESS', description: 'No access (usually indicates sign-in is necessary)', value: Gitlab::Access::NO_ACCESS
+    value 'GUEST', description: 'Guest access to public environments', value: Gitlab::Access::GUEST
+    value 'REPORTER', description: 'Reporter access to public environments', value: Gitlab::Access::REPORTER
+    value 'DEVELOPER', description: 'Developer access (includes maintainers)', value: Gitlab::Access::DEVELOPER
+    value 'MAINTAINER', description: 'Maintainer access', value: Gitlab::Access::MAINTAINER
+    value 'OWNER', description: 'Code owner access (administrator access)', value: Gitlab::Access::OWNER
   end
 end

doc/api/graphql/reference/index.md

@@ -4889,12 +4889,12 @@ Access level to a resource.
 
 | Value | Description |
 | ----- | ----------- |
-| `DEVELOPER` |  |
-| `GUEST` |  |
-| `MAINTAINER` |  |
-| `NO_ACCESS` |  |
-| `OWNER` |  |
-| `REPORTER` |  |
+| `DEVELOPER` | Developer access (includes maintainers) |
+| `GUEST` | Guest access to public environments |
+| `MAINTAINER` | Maintainer access |
+| `NO_ACCESS` | No access (usually indicates sign-in is necessary) |
+| `OWNER` | Code owner access (administrator access) |
+| `REPORTER` | Reporter access to public environments |
 
 ### AlertManagementAlertSort