Merge branch '337993-add-repository-push-audit-event-to-deprecations-list' into 'master'

Add deprecation entry for repository push events

See merge request gitlab-org/gitlab!70215

data/deprecations/14-3-repository-push-audit-events.yml

+- name: "Audit events for repository push events"
+  announcement_milestone: "14.3" # The milestone when this feature was first announced as deprecated.
+  removal_milestone: "15.0" # the milestone when this feature is planned to be removed
+  body: | # Do not modify this line, instead modify the lines below.
+    Audit events for [repository events](../administration/audit_events.md#repository-push) are now deprecated and will be removed in GitLab 15.0.
+
+    These events have always been disabled by default and had to be manually enabled with a
+    feature flag. Enabling them can cause too many events to be generated which can
+    dramatically slow down GitLab instances. For this reason, they are being removed.
+  stage: Manage
+  tiers: Premium
+  issue_url: https://gitlab.com/gitlab-org/gitlab/-/issues/337993
+  documentation_url: ../administration/audit_events.md
+  announcement_date: 2021-09-02 # https://gitlab.com/gitlab-org/gitlab/-/merge_requests/69024

doc/update/deprecations.md

@@ -16,4 +16,12 @@ To add a deprecation, use the example.yml file in `/data/deprecations/templates`
 then run `bin/rake gitlab:docs:compile_deprecations`.
 -->
 
-Deprecated features scheduled for removal will be listed here, sorted by GitLab milestone.
+## 15.0
+
+### Audit events for repository push events
+
+Audit events for [repository events](../administration/audit_events.md#repository-push) are now deprecated and will be removed in GitLab 15.0.
+
+These events have always been disabled by default and had to be manually enabled with a
+feature flag. Enabling them can cause too many events to be generated which can
+dramatically slow down GitLab instances. For this reason, they are being removed.