Skip to content

Conversation

@theodesp
Copy link
Member

@theodesp theodesp commented Mar 18, 2025

#52

@theodesp theodesp requested a review from a team as a code owner March 18, 2025 11:08
@theodesp theodesp changed the title Explanation document: which queries to use docs: explanation on which queries to use Mar 18, 2025
josephfusco
josephfusco previously approved these changes Mar 18, 2025
Copy link
Member

@moonmeister moonmeister left a comment

Choose a reason for hiding this comment

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

Looks good. I find it a little odd that in Faust we use ?graphql but here we recommend /graphql. I've reworked a couple sections to clearly outline benefits of either without strongly recommending one or the other. Feel free to take these suggestions as-is or rework them as you see fit.

@moonmeister
Copy link
Member

moonmeister commented Mar 18, 2025

can we also rename this to something like graphql-endpoints.md the current name is confusing to me.

Copy link
Member

@moonmeister moonmeister left a comment

Choose a reason for hiding this comment

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

LGTM!

Copy link
Member

@josephfusco josephfusco left a comment

Choose a reason for hiding this comment

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

This reads well @theodesp 🙌🏼

@josephfusco josephfusco added this pull request to the merge queue Mar 19, 2025
Merged via the queue into main with commit cce8a9d Mar 19, 2025
1 check passed
@josephfusco josephfusco deleted the explanation-which-queries-to-use-2 branch March 19, 2025 17:59
@colinmurphy
Copy link
Member

@theodesp Great PR for docs. Very easy to read and understand ❤️

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants