Update deprecation information of User.email

app/graphql/types/user_type.rb

@@ -24,7 +24,7 @@ module Types
           description: 'State of the user.'
     field :email, GraphQL::STRING_TYPE, null: true,
           description: 'User email.', method: :public_email,
-          deprecated: { reason: 'Use public_email', milestone: '13.7' }
+          deprecated: { reason: :renamed, replacement: 'User.publicEmail', milestone: '13.7' }
     field :public_email, GraphQL::STRING_TYPE, null: true,
           description: "User's public email."
     field :avatar_url, GraphQL::STRING_TYPE, null: true,

doc/api/graphql/reference/index.md

@@ -6494,7 +6494,7 @@ Representation of a GitLab user.
 | `avatarUrl` | [`String`](#string) | URL of the user's avatar. |
 | `bot` | [`Boolean!`](#boolean) | Indicates if the user is a bot. |
 | `callouts` | [`UserCalloutConnection`](#usercalloutconnection) | User callouts that belong to the user. |
-| `email` **{warning-solid}** | [`String`](#string) | **Deprecated** in 13.7. Use public_email. |
+| `email` **{warning-solid}** | [`String`](#string) | **Deprecated** in 13.7. This was renamed. Use: `User.publicEmail`. |
 | `groupCount` | [`Int`](#int) | Group count for the user. Available only when feature flag `user_group_counts` is enabled. |
 | `groupMemberships` | [`GroupMemberConnection`](#groupmemberconnection) | Group memberships of the user. |
 | `id` | [`ID!`](#id) | ID of the user. |