Skip to content

Remove "subscriptions is a significant change" sentence#983

Merged
benjie merged 8 commits intographql:mainfrom
rivantsov:P19_change2challenge
Jul 8, 2023
Merged

Remove "subscriptions is a significant change" sentence#983
benjie merged 8 commits intographql:mainfrom
rivantsov:P19_change2challenge

Conversation

@rivantsov
Copy link
Copy Markdown
Contributor

Explanation, current version:

Supporting subscriptions is a significant change for any GraphQL service.

who is changing what? why we assume certain order of building GraphQL service - queries mutations first, then subscriptions. what if I built all in parallel.

I think 'challenge' makes more sense in the context of the section.

@netlify
Copy link
Copy Markdown

netlify Bot commented Aug 3, 2022

Deploy Preview for graphql-spec-draft ready!

Name Link
🔨 Latest commit 2f87dd1
🔍 Latest deploy log https://app.netlify.com/sites/graphql-spec-draft/deploys/63ca41ccba58c70009da24e7
😎 Deploy Preview https://deploy-preview-983--graphql-spec-draft.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site settings.

@benjie
Copy link
Copy Markdown
Member

benjie commented Dec 7, 2022

From Dec WG: "Supporting subscriptions requires a different approach to queries and mutations." -- @mjmahone

Copy link
Copy Markdown
Member

@benjie benjie left a comment

Choose a reason for hiding this comment

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

My thought is that we shouldn't use the word "challenge" because it's emotive and subjective. It seems that most users building out a GraphQL schema tend to implement queries first, then mutations, then possibly later subscriptions - so for the majority of users it is in fact a change. However, Roman is right that it may not be a change if you support subscriptions from the get-go, so Matt's suggestion is to change the sentence entirely (see above) to be more objective and yet convey similar meaning to the original text.

@rivantsov
Copy link
Copy Markdown
Contributor Author

Matt's suggestion:

Supporting subscriptions requires a different approach to queries and mutations.

I am still not quite happy with this. Is it "to queries and mutations" or "COMPARED to queries and mutations"?
A few things to point out I think that would help:

  1. This is an introductory sentence to a new topic. It does not have to be much meaningful or say something specific about subscriptions. We actually struggle against the unintended "meaning" we bring in - that it is a CHANGE, or a CHALLENGE (beware it is difficult) and so on. We can just say meaningless thing like "This chapter is about another feature - Subscriptions"
  2. If we do want to add something "meat" - subscriptions are different. We can say that they use different interaction model, not classic HTTP request response. Client requests, server responds. We have to go outside HTTP, and use WebSockets.

Comment thread spec/Section 6 -- Execution.md Outdated
@rivantsov
Copy link
Copy Markdown
Contributor Author

@benjie , can you pls help with this 'code style/pretier' failure, have no idea what to do about it

@benjie
Copy link
Copy Markdown
Member

benjie commented Jan 12, 2023

If you have node installed, in the root of the repo run npm install and then npm run format

@rivantsov rivantsov requested a review from benjie January 20, 2023 07:28
Copy link
Copy Markdown
Member

@benjie benjie left a comment

Choose a reason for hiding this comment

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

This looks good to me. @graphql/tsc can I get another +1?

@benjie benjie changed the title Changed 'change' to 'challenge' about subscriptions Remove "subscriptions is a significant change" sentence Jul 8, 2023
@benjie benjie merged commit 6b7c2c4 into graphql:main Jul 8, 2023
@benjie
Copy link
Copy Markdown
Member

benjie commented Jul 8, 2023

Thanks @Keweiqu and @rivantsov 🙌

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