From 7a253f9e1c99abf447c52b950174c5e717310c45 Mon Sep 17 00:00:00 2001
From: Segolene Bouly <6041195-sbouly@users.noreply.gitlab.com>
Date: Fri, 1 Aug 2025 17:47:57 +0100
Subject: [PATCH] Move Rails console instructions for needs limit

---
 doc/administration/cicd/_index.md     | 14 ++------------
 doc/administration/instance_limits.md | 13 +++++++++++++
 2 files changed, 15 insertions(+), 12 deletions(-)

diff --git a/doc/administration/cicd/_index.md b/doc/administration/cicd/_index.md
index e3609f8637b8be..61e5aa32c9d6bf 100644
--- a/doc/administration/cicd/_index.md
+++ b/doc/administration/cicd/_index.md
@@ -63,7 +63,7 @@ For Linux package installations:
    sudo gitlab-ctl reconfigure
    ```
 
-## Set the `needs` job limit
+## Set the CI/CD limits
 
 {{< details >}}
 
@@ -72,17 +72,7 @@ For Linux package installations:
 
 {{< /details >}}
 
-The maximum number of jobs that can be defined in `needs` defaults to 50.
-
-A GitLab administrator with [access to the GitLab Rails console](../operations/rails_console.md#starting-a-rails-console-session)
-can choose a custom limit. For example, to set the limit to `100`:
-
-```ruby
-Plan.default.actual_limits.update!(ci_needs_size_limit: 100)
-```
-
-To disable `needs` dependencies, set the limit to `0`. Pipelines with jobs
-configured to use `needs` then return the error `job can only need 0 others`.
+To set CI/CD limits for a GitLab Self-Managed instance, you can do it [through the **Admin area**](../../administration/settings/continuous_integration.md#set-cicd-limits) or [the GitLab Rails console](../../administration/instance_limits.md#cicd-limits).
 
 ## Change maximum scheduled pipeline frequency
 
diff --git a/doc/administration/instance_limits.md b/doc/administration/instance_limits.md
index 9b79aacae3bdc4..cfc374fdef9623 100644
--- a/doc/administration/instance_limits.md
+++ b/doc/administration/instance_limits.md
@@ -717,6 +717,19 @@ Plan.default.actual_limits.update!(security_policy_scan_execution_schedules: 100
 
 This limit is [enabled on GitLab.com](../user/gitlab_com/_index.md#cicd).
 
+### Number of needs dependencies that a job can have
+
+The maximum number of jobs that can be defined in [`needs`](../ci/yaml/_index.md#needs) defaults to 50.
+
+To set these limits for a GitLab Self-Managed instance or a Dedicated instance, you can do it [through the Admin area](../administration/settings/continuous_integration.md#set-cicd-limits) or for Self-Managed instances only [access to the GitLab Rails console](operations/rails_console.md#starting-a-rails-console-session) to choose a custom limit. For example, to set the limit to `100`:
+
+```ruby
+Plan.default.actual_limits.update!(ci_needs_size_limit: 100)
+```
+
+To disable `needs` dependencies, set the limit to `0`. Pipelines with jobs
+configured to use `needs` then return the error `job can only need 0 others`.
+
 ### CI/CD variable limits
 
 {{< history >}}
-- 
GitLab