Tweak wording

To match the proposal in https://gitlab.com/gitlab-org/gitlab/-/merge_requests/77815

doc/api/graphql/reference/index.md

@@ -17690,10 +17690,10 @@ The state of the vulnerability.
 | Value | Description |
 | ----- | ----------- |
-| <a id="vulnerabilitystateconfirmed"></a>`CONFIRMED` | Confirmed vulnerability. |
-| <a id="vulnerabilitystatedetected"></a>`DETECTED` | Detected vulnerability. |
-| <a id="vulnerabilitystatedismissed"></a>`DISMISSED` | Dismissed vulnerability. |
-| <a id="vulnerabilitystateresolved"></a>`RESOLVED` | Resolved vulnerability. |
+| <a id="vulnerabilitystateconfirmed"></a>`CONFIRMED` | For details, see [vulnerability status values](https://docs.gitlab.com/ee/user/application_security/vulnerabilities/index.html#vulnerability-status-values). |
+| <a id="vulnerabilitystatedetected"></a>`DETECTED` | For details, see [vulnerability status values](https://docs.gitlab.com/ee/user/application_security/vulnerabilities/index.html#vulnerability-status-values). |
+| <a id="vulnerabilitystatedismissed"></a>`DISMISSED` | For details, see [vulnerability status values](https://docs.gitlab.com/ee/user/application_security/vulnerabilities/index.html#vulnerability-status-values). |
+| <a id="vulnerabilitystateresolved"></a>`RESOLVED` | For details, see [vulnerability status values](https://docs.gitlab.com/ee/user/application_security/vulnerabilities/index.html#vulnerability-status-values). |
 ### `WeightWildcardId`

doc/user/application_security/vulnerabilities/index.md

@@ -37,7 +37,7 @@ A vulnerability's status can be one of the following:
 
 | Status    | Description |
 |:----------|:------------|
-| Detected  | The default state for a newly discovered vulnerability. |
+| Detected  | The default state for a newly discovered vulnerability. Appears as "Needs triage" in the UI. |
 | Confirmed | A user has seen this vulnerability and confirmed it to be accurate. |
 | Dismissed | A user has seen this vulnerability and dismissed it because it is not accurate or otherwise not to be resolved. |
 | Resolved  | The vulnerability has been fixed or is no longer present. |

ee/app/graphql/types/vulnerability_state_enum.rb

@@ -5,8 +5,13 @@ class VulnerabilityStateEnum < BaseEnum
     graphql_name 'VulnerabilityState'
     description 'The state of the vulnerability'
 
-    ::Vulnerability.states.keys.each do |state|
-      value state.to_s.upcase, value: state.to_s, description: "#{state.to_s.titleize} vulnerability"
-    end
+    # FIXME: https://gitlab.com/gitlab-org/gitlab/-/issues/350109
+    DESCRIPTION_TEXT = 'For details, see [vulnerability status values]' \
+                       '(https://docs.gitlab.com/ee/user/application_security/vulnerabilities/index.html#vulnerability-status-values).'
+
+    value 'CONFIRMED', value: 'confirmed', description: DESCRIPTION_TEXT
+    value 'DETECTED', value: 'detected', description: DESCRIPTION_TEXT
+    value 'DISMISSED', value: 'dismissed', description: DESCRIPTION_TEXT
+    value 'RESOLVED', value: 'resolved', description: DESCRIPTION_TEXT
   end
 end