Skip to content

feat(discover): Add docs for organization_events #34768

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 11 commits into from
Jun 2, 2022
Merged

Conversation

wmak
Copy link
Member

@wmak wmak commented May 18, 2022

  • 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

image

- This adds a new doc sections for Visibility called `Discover and
  Performance`
@wmak wmak marked this pull request as ready for review May 31, 2022 20:53
@wmak wmak requested a review from a team as a code owner May 31, 2022 20:53
@wmak wmak requested a review from a team May 31, 2022 20:53
@wmak wmak requested a review from a team as a code owner May 31, 2022 20:53
@@ -17,6 +18,50 @@ class GLOBAL_PARAMS:
type=str,
location="path",
)
STATS_PERIOD = OpenApiParameter(
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think OpenApiParameter maps to URL parameters, not query parameters

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

drf serializers map to query parameters

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

@@ -46,6 +91,51 @@ class ISSUE_ALERT_PARAMS:
)


class VISIBILITY_PARAMS:
QUERY = OpenApiParameter(
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

@wmak wmak requested a review from AniketDas-Tekky June 1, 2022 15:47
Copy link
Contributor

@edwardgou-sentry edwardgou-sentry left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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

@edwardgou-sentry
Copy link
Contributor

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.

image

Co-authored-by: edwardgou-sentry <[email protected]>
Co-authored-by: Ash Anand <[email protected]>
@wmak wmak merged commit c34a898 into master Jun 2, 2022
@wmak wmak deleted the wmak/feat/org-events-docs branch June 2, 2022 19:14
@github-actions github-actions bot locked and limited conversation to collaborators Jun 18, 2022
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants