Skip to content

Docs: Consolidate and reorganize CI/CD limits documentation

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.
  • Start this issue's title with Docs: or Docs feedback:.

Problem to solve

CI/CD limits are currently documented in two separate locations with significant overlap and inconsistent guidance:

This creates several issues:

  • Duplication: Same limits documented in multiple places with potentially inconsistent information.
  • Poor user experience: Users must navigate between pages to understand all available limits.
  • Inconsistent guidance: Mixed recommendations for console vs UI configuration methods.
  • Page bloat: The instance limits page is extremely long due to the extensive CI/CD section.

Further details

This affects administrators managing GitLab instances who need to configure CI/CD limits for:

  • Performance management and resource control
  • Preventing abuse and system overload
  • Compliance with organizational policies

Proposal

Create a dedicated CI/CD limits page that consolidates all CI/CD limit documentation with clear organization:

  1. UI-configurable limits section
  2. Console-only limits section

Additional considerations

  • Ensure all limit values and default settings are accurate and up-to-date
  • Consider adding a comparison table showing which limits can be set via UI vs console
  • Review related GitLab.com limits documentation for consistency
  • Update any existing links that point to the CI/CD section of instance limits page

Other links/references

Edited by 🤖 GitLab Bot 🤖