Clarify epic delete warning

- add changelog
- change button text to 'delete epic'

app/assets/javascripts/issue_show/components/edit_actions.vue

@@ -45,15 +45,23 @@ export default {
     shouldShowDeleteButton() {
       return this.canDestroy && this.showDeleteButton;
     },
+    deleteIssuableButtonText() {
+      return sprintf(__('Delete %{issuableType}'), {
+        issuableType: issuableTypes[this.issuableType],
+      });
+    },
   },
   methods: {
     closeForm() {
       eventHub.$emit('close.form');
     },
     deleteIssuable() {
-      const confirmMessage = sprintf(__('%{issuableType} will be removed! Are you sure?'), {
-        issuableType: issuableTypes[this.issuableType],
-      });
+      const confirmMessage =
+        this.issuableType === 'epic'
+          ? __('Delete this epic and all descendants?')
+          : sprintf(__('%{issuableType} will be removed! Are you sure?'), {
+              issuableType: issuableTypes[this.issuableType],
+            });
       // eslint-disable-next-line no-alert
       if (window.confirm(confirmMessage)) {
         this.deleteLoading = true;
@@ -90,7 +98,7 @@ export default {
       class="float-right gl-mr-3 qa-delete-button"
       @click="deleteIssuable"
     >
-      {{ __('Delete') }}
+      {{ deleteIssuableButtonText }}
     </gl-button>
   </div>
 </template>

changelogs/unreleased/321752-cablett-delete-epic-warning.yml

+---
+title: Clarify epic delete warning
+merge_request: 55574
+author:
+type: changed

doc/user/group/epics/manage_epics.md

@@ -75,6 +75,9 @@ A modal appears to confirm your action.
 
 Deleting an epic releases all existing issues from their associated epic in the system.
 
+WARNING:
+If you delete an epic, all its child epics and their descendants are deleted as well. If needed, you can [remove child epics](#remove-a-child-epic-from-a-parent-epic) from the parent epic before you delete it.
+
 ## Close an epic
 
 Whenever you decide that there is no longer need for that epic,

ee/spec/features/epics/delete_epic_spec.rb

@@ -31,8 +31,8 @@ RSpec.describe 'Delete Epic', :js do
     end
 
     it 'deletes the issue and redirect to epic list' do
-      page.accept_alert 'Epic will be removed! Are you sure?' do
-        find(:button, text: 'Delete').click
+      page.accept_alert 'Delete this epic and all descendants?' do
+        find(:button, text: 'Delete Epic').click
       end
 
       wait_for_requests

locale/gitlab.pot

@@ -9766,6 +9766,9 @@ msgstr ""
 msgid "Delete"
 msgstr ""
 
+msgid "Delete %{issuableType}"
+msgstr ""
+
 msgid "Delete %{name}"
 msgstr ""
 
@@ -9823,6 +9826,9 @@ msgstr ""
 msgid "Delete this attachment"
 msgstr ""
 
+msgid "Delete this epic and all descendants?"
+msgstr ""
+
 msgid "Delete user list"
 msgstr ""