feat(discover): Add docs for organization_events

[wmak]

• This adds a new doc sections for Visibility called Discover and Performance
• This adds the first Discover endpoint we're publicizing the events endpoint (which replaces the soon to be deprecated eventsv2 endpoint) as the first endpoint in the documentation

Preview

[AniketDas-Tekky]

I think OpenApiParameter maps to URL parameters, not query parameters

[AniketDas-Tekky]

drf serializers map to query parameters

[wmak]

I don't think so, its what the location param on the OpenApiParameter is for so you can define whether the parameter is a part of the path or the query

Based on docs you can do header, cookie or form parameters too:
https://drf-spectacular.readthedocs.io/en/latest/drf_yasg.html?highlight=location#parameter-location

[AniketDas-Tekky]

Is this a visibility-only param? I think we use it in several places outside of visibility.

[wmak]

This is a specific Query to Visibility (see the bit about the search syntax)

[edwardgou-sentry]

Have some suggestions! Feel free to pick and choose or edit.

[edwardgou-sentry]

Also, probably out of scope for this pr, but I think this part should say something like, You need authorization via bearer auth token, since authentication is a different thing. This part lives in the docs repo though so definitely not for this pr.