Merge branch 'deprecate-external-field-in-graphql-release-asset-link-type' into 'master'

Announce deprecation of `external` in GraphQL ReleaseAssetLink type

See merge request https://gitlab.com/gitlab-org/gitlab/-/merge_requests/109704



Merged-by: Russell Dickenson <rdickenson@gitlab.com>
Approved-by: Vladimir Shushlin <vshushlin@gitlab.com>
Approved-by: Russell Dickenson <rdickenson@gitlab.com>
Co-authored-by: Ahmed Hemdan <ahemdan@gitlab.com>

data/deprecations/15-9-deprecate-external-field-in-graphql-release-asset-link.yml

+- title: "External field in GraphQL ReleaseAssetLink type"
+  announcement_milestone: "15.9"
+  announcement_date: "2023-02-22"
+  removal_milestone: "16.0"
+  removal_date: "2023-05-22"
+  breaking_change: true
+  reporter: ahmed.hemdan
+  body: |
+    In the [GraphQL API](https://docs.gitlab.com/ee/api/graphql), the `external` field of [`ReleaseAssetLink` type](https://docs.gitlab.com/ee/api/graphql/reference/index.html#releaseassetlink) was used to indicate whether a [release link](https://docs.gitlab.com/ee/user/project/releases/release_fields.html#links) is internal or external to your GitLab instance.
+    As of GitLab 15.9, we treat all release links as external, and therefore, this field is deprecated in GitLab 15.9, and will be removed in GitLab 16.0.
+    To avoid any disruptions to your workflow, please stop using the `external` field because it will be removed and will not be replaced.
+  stage: Release
+  issue_url:

doc/update/deprecations.md

@@ -161,6 +161,22 @@ During the transition to the GitLab Observability UI, we will migrate the [GitLa
 <div class="deprecation removal-160 breaking-change">
+### External field in GraphQL ReleaseAssetLink type
+
+Planned removal: GitLab <span class="removal-milestone">16.0</span> <span class="removal-date"></span>
+
+WARNING:
+This is a [breaking change](https://docs.gitlab.com/ee/development/deprecation_guidelines/).
+Review the details carefully before upgrading.
+
+In the [GraphQL API](https://docs.gitlab.com/ee/api/graphql), the `external` field of [`ReleaseAssetLink` type](https://docs.gitlab.com/ee/api/graphql/reference/index.html#releaseassetlink) was used to indicate whether a [release link](https://docs.gitlab.com/ee/user/project/releases/release_fields.html#links) is internal or external to your GitLab instance.
+As of GitLab 15.9, we treat all release links as external, and therefore, this field is deprecated in GitLab 15.9, and will be removed in GitLab 16.0.
+To avoid any disruptions to your workflow, please stop using the `external` field because it will be removed and will not be replaced.
+
+</div>
+
+<div class="deprecation removal-160 breaking-change">
+
 ### External field in Releases and Release Links APIs
 Planned removal: GitLab <span class="removal-milestone">16.0</span> <span class="removal-date"></span>