From 69f46b05db9853c72e4d2fdc746a02221bc31ce5 Mon Sep 17 00:00:00 2001
From: Vasilii Iakliushin <viakliushin@gitlab.com>
Date: Fri, 27 Sep 2024 09:42:45 +0000
Subject: [PATCH] Docs: clarify prerequisites for project deletion

Contributes to https://gitlab.com/gitlab-org/gitlab/-/issues/490915

Cover an edge case that prevents users from deleting a project.
---
 .../settings/visibility_and_access_controls.md               | 5 +++++
 doc/user/project/working_with_projects.md                    | 1 +
 2 files changed, 6 insertions(+)

diff --git a/doc/administration/settings/visibility_and_access_controls.md b/doc/administration/settings/visibility_and_access_controls.md
index 25667959176c5..e1e59ed864783 100644
--- a/doc/administration/settings/visibility_and_access_controls.md
+++ b/doc/administration/settings/visibility_and_access_controls.md
@@ -65,6 +65,11 @@ To restrict project deletion to only administrators:
    - (GitLab 15.0 and earlier) **Default project deletion protection**, and select **Only admins can delete project**.
 1. Select **Save changes**.
 
+To disable the restriction:
+
+1. Select **Owners and administators**.
+1. Select **Save changes**.
+
 ## Deletion protection
 
 DETAILS:
diff --git a/doc/user/project/working_with_projects.md b/doc/user/project/working_with_projects.md
index 2f3548b598d6f..b340ab2d7f5b1 100644
--- a/doc/user/project/working_with_projects.md
+++ b/doc/user/project/working_with_projects.md
@@ -156,6 +156,7 @@ After you delete a project:
 Prerequisites:
 
 - You must have the Owner role for a project.
+- Owners must be [allowed to delete projects](../../administration/settings/visibility_and_access_controls.md#restrict-project-deletion-to-administrators).
 
 To delete a project:
 
-- 
GitLab