Merge the Alerts and [Alert] Integrations doc pages
Problem to solve
Our current documentation is a bit disjointed. We have an Incident Management section which covers the various features of our Incident Management solution:
- Alerts
- Incidents
- On-call management
- Status page
- Metrics Dashboard
- We also have
Integrations
This Integrations page shows information around setting up the GitLab Alerts endpoint, the payload structure expected for those alerts and information around automatic grouping etc.
Having these two sections split up is confusing (even for me, having built these features). It's hard to find the information you need.
Proposal
This information should be moved to the Alerts section. Once we have done this we can probably remove the Integrations completely.
The Alerts section could probably be split into to pages:
- The Alert UI and how to interact with it
- The process of cresting alerts with the HTTP endpoint, payload setup instructions etc.
Who can address the issue
Other links/references
Edited by Marcin Sedlak-Jakubowski (ex-GitLab)