Events API documentation should reference Discussions documentation
Problem to solve
I spent some time trying to work out how to get events relating to an issue being added to / removed from a given milestone. Only after inspecting the gitlab page did I find it exists as discussions.json - which lead me to the Discussions API. "Discussions" seems an odd name for this data - perhaps the Events API page could include a summary of other "event" related APIs that the user might also want to look at. (E.g. as well as discussions, audit events would be worth highlighting)
Further details
Proposal
Summary table on the "Events API" page of "other APIs that have event related information", with examples of the kind of things that are listed there.