graphql / graphql.github.io

GraphQL Documentation at graphql.org

Home Page:https://graphql.org

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Order of the "Queries and Mutation" sections on the Learn Page

OliverSieweke opened this issue · comments

Thank you for the very readable and well organized Learn material on the website. This is just to propose a slight change in the order of the sections of the Query and Mutation page.

The Operations Name section specifies:

Up until now, we have been using a shorthand syntax where we omit both the query keyword and the query name

Which is not quite true as the previous Fragments section provides the following example:

query HeroComparison($first: Int = 3) {
  leftComparison: hero(episode: EMPIRE) {
    ...comparisonFields
  }
  rightComparison: hero(episode: JEDI) {
    ...comparisonFields
  }
}

It might therefore make sense to swap around the order of the Fragments and Operations Name sections.

Hi,

Raised a PR. Hopefully, this will resolve the issue.