Clean up documentation on application limits

Everyone can contribute. Help move this issue forward while earning points, leveling up and collecting rewards.

• Close this issue

Problem to solve

We have a few different pages describing Application Limits:

• https://docs.gitlab.com/ee/administration/instance_limits.html
  • Mainly intended for administrators of self-managed instances.
• https://docs.gitlab.com/ee/user/gitlab_com/index.html
  • Actual limits for gitlab.com, and other details about the configuration (not only limits).
• https://docs.gitlab.com/ee/security/rate_limits.html
  • This is more of a one-off page from a security perspective.
• Various other pages for limits that can be configured directly in the UI.
  • e.g. https://docs.gitlab.com/ee/user/admin_area/settings/rate_limit_on_issues_creation.html

This issue is mainly about the first two pages. AFAIK these were mostly created ad-hoc by all the different teams adding various kinds of new application limits 😉

When adding new limits it's tricky to decide under which headings to put them, and I assume for users it's confusing to read and navigate these pages.

Further details

Previous discussions which prompted this issue:

• !62918 (comment 590064376), !62918 (comment 592564833)
• !61151 (comment 570146758)

Proposal

Can we introduce a shared information architecture for these pages?

There are various aspects to consider:

• Different types of limits (e.g. rate-limit, size limits, etc.)
• Configurable/non-configurable limits (and also configurable in the UI vs. through other means)
• Changes to limits over time (see e.g. https://docs.gitlab.com/ee/user/gitlab_com/index.html#gitlabcom-specific-rate-limits)
• Different limits per product tier (see e.g. https://docs.gitlab.com/ee/user/gitlab_com/index.html#gitlab-cicd)

Who can address the issue

Other links/references