Clean up documentation on application limits
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.
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:
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)