search

graphql / composite-schemas-spec

MIT License
30 stars 9 forks source link

Terminology: gateway v.s. distributed executor #22

Closed SimonSapin closed 9 months ago

SimonSapin commented 9 months ago

The term "gateway" is use a few times across this repository. For example:

https://github.com/graphql/composite-schemas-spec/blob/aaf454b186184e7e7fe7000aefd41169f747c4dd/spec/Section%201%20--%20Overview.md#L43-L45

Based on the existence of @apollo/gateway I can guess it is used interchangeably with "distributed (GraphQL) executor", which has a proper definition in the Overview. I suggest using "execution" or "distributed executor" everywhere. (No need to repeat "GraphQL" every time, this being a document of the GraphQL WG.)

benjie commented 9 months ago

Agree that we should standardize on terminology and use the same terms everywhere - we can use spec-md's definitions feature to link to the definition of the word.

This may be a duplicate of https://github.com/graphql/composite-schemas-spec/issues/17 where the correct term to use is under discussion?

SimonSapin commented 9 months ago

Indeed, closing as duplicate of https://github.com/graphql/composite-schemas-spec/issues/17