Skip to content
This repository has been archived by the owner on Apr 14, 2023. It is now read-only.

Made language a little clearer. #282

Merged
merged 2 commits into from
Oct 6, 2017
Merged

Made language a little clearer. #282

merged 2 commits into from
Oct 6, 2017

Conversation

sheeldotme
Copy link
Contributor

@sheeldotme sheeldotme commented Sep 30, 2017

"This" in the top comment is a little unclear as it's unclear whether that comment refers to just the next message type or the entire block.
"Those" on the bottom comment is a little unclear as "those" is past tense, it could refer to the preceding message types.

TODO:

  • Make sure all of the significant new logic is covered by tests
  • Rebase your changes on master so that they can be merged easily
  • Make sure all tests and linter rules pass
  • Update CHANGELOG.md with your change

"This" in the top comment is a little unclear as it's unclear whether that comment refers to just the next message type or the entire block.
"Those" on the bottom comment is a little unclear as "those" is past tense, it could refer to the preceding message types.
@@ -3,7 +3,7 @@ export default class MessageTypes {
public static GQL_CONNECTION_ACK = 'connection_ack'; // Server -> Client
public static GQL_CONNECTION_ERROR = 'connection_error'; // Server -> Client

// NOTE: This one here don't follow the standard due to connection optimization
// NOTE: These message types do not follow the standard due to connection optimizations
Copy link
Contributor

Choose a reason for hiding this comment

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

this is not true for all message types, just for KEEP_ALIVE..

@@ -12,7 +12,7 @@ export default class MessageTypes {
public static GQL_COMPLETE = 'complete'; // Server -> Client
public static GQL_STOP = 'stop'; // Client -> Server

// NOTE: Those message types are deprecated and will be removed soon.
// NOTE: These message types are deprecated and will be removed soon.
Copy link
Contributor

Choose a reason for hiding this comment

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

👍

@stubailo
Copy link
Contributor

stubailo commented Oct 3, 2017

@sheeldotme any updates on this?

@sheeldotme
Copy link
Contributor Author

I think the fact that I tried to interpret it the best I could, and failed shows there's some opportunity for clarification here. I've taken @DxCx's helpful feedback into account and updated the comment.

@NeoPhi NeoPhi merged commit d6f2a51 into apollographql:master Oct 6, 2017
@NeoPhi
Copy link
Contributor

NeoPhi commented Oct 6, 2017

Thank you for the documentation update!

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