Update introspection docs (graphql#1812)

Co-authored-by: Benjie <[email protected]>

Author: mandiwise

src/components/marked/swapi-schema.tsx

@@ -17,7 +17,7 @@ const typeDefs = /* GraphQL */ `
     mutation: Mutation
   }
 
-  # The query type, represents all of the entry points into our object graph
+  "The query type, represents all of the entry points into our object graph"
   type Query {
     hero(episode: Episode): Character
     reviews(episode: Episode!): [Review]
@@ -28,155 +28,155 @@ const typeDefs = /* GraphQL */ `
     starship(id: ID!): Starship
   }
 
-  # The mutation type, represents all updates we can make to our data
+  "The mutation type, represents all updates we can make to our data"
   type Mutation {
     createReview(episode: Episode, review: ReviewInput!): Review
   }
 
-  # The episodes in the Star Wars trilogy
+  "The episodes in the Star Wars trilogy"
   enum Episode {
-    # Star Wars Episode IV: A New Hope, released in 1977.
+    "Star Wars Episode IV: A New Hope, released in 1977."
     NEWHOPE
 
-    # Star Wars Episode V: The Empire Strikes Back, released in 1980.
+    "Star Wars Episode V: The Empire Strikes Back, released in 1980."
     EMPIRE
 
-    # Star Wars Episode VI: Return of the Jedi, released in 1983.
+    "Star Wars Episode VI: Return of the Jedi, released in 1983."
     JEDI
   }
 
-  # A character from the Star Wars universe
+  "A character from the Star Wars universe"
   interface Character {
-    # The ID of the character
+    "The ID of the character"
     id: ID!
 
-    # The name of the character
+    "The name of the character"
     name: String!
 
-    # The friends of the character, or an empty list if they have none
+    "The friends of the character, or an empty list if they have none"
     friends: [Character]
 
-    # The friends of the character exposed as a connection with edges
+    "The friends of the character exposed as a connection with edges"
     friendsConnection(first: Int, after: ID): FriendsConnection!
 
-    # The movies this character appears in
+    "The movies this character appears in"
     appearsIn: [Episode]!
   }
 
-  # Units of height
+  "Units of height"
   enum LengthUnit {
-    # The standard unit around the world
+    "The standard unit around the world"
     METER
 
-    # Primarily used in the United States
+    "Primarily used in the United States"
     FOOT
   }
 
-  # A humanoid creature from the Star Wars universe
+  "A humanoid creature from the Star Wars universe"
   type Human implements Character {
-    # The ID of the human
+    "The ID of the human"
     id: ID!
 
-    # What this human calls themselves
+    "What this human calls themselves"
     name: String!
 
-    # Height in the preferred unit, default is meters
+    "Height in the preferred unit, default is meters"
     height(unit: LengthUnit = METER): Float
 
-    # Mass in kilograms, or null if unknown
+    "Mass in kilograms, or null if unknown"
     mass: Float
 
-    # This human's friends, or an empty list if they have none
+    "This human's friends, or an empty list if they have none"
     friends: [Character]
 
-    # The friends of the human exposed as a connection with edges
+    "The friends of the human exposed as a connection with edges"
     friendsConnection(first: Int, after: ID): FriendsConnection!
 
-    # The movies this human appears in
+    "The movies this human appears in"
     appearsIn: [Episode]!
 
-    # A list of starships this person has piloted, or an empty list if none
+    "A list of starships this person has piloted, or an empty list if none"
     starships: [Starship]
   }
 
-  # An autonomous mechanical character in the Star Wars universe
+  "An autonomous mechanical character in the Star Wars universe"
   type Droid implements Character {
-    # The ID of the droid
+    "The ID of the droid"
     id: ID!
 
-    # What others call this droid
+    "What others call this droid"
     name: String!
 
-    # This droid's friends, or an empty list if they have none
+    "This droid's friends, or an empty list if they have none"
     friends: [Character]
 
-    # The friends of the droid exposed as a connection with edges
+    "The friends of the droid exposed as a connection with edges"
     friendsConnection(first: Int, after: ID): FriendsConnection!
 
-    # The movies this droid appears in
+    "The movies this droid appears in"
     appearsIn: [Episode]!
 
-    # This droid's primary function
+    "This droid's primary function"
     primaryFunction: String
   }
 
-  # A connection object for a character's friends
+  "A connection object for a character's friends"
   type FriendsConnection {
-    # The total number of friends
+    "The total number of friends"
     totalCount: Int
 
-    # The edges for each of the character's friends.
+    "The edges for each of the character's friends."
     edges: [FriendsEdge]
 
-    # A list of the friends, as a convenience when edges are not needed.
+    "A list of the friends, as a convenience when edges are not needed."
     friends: [Character]
 
-    # Information for paginating this connection
+    "Information for paginating this connection"
     pageInfo: PageInfo!
   }
 
-  # An edge object for a character's friends
+  "An edge object for a character's friends"
   type FriendsEdge {
-    # A cursor used for pagination
+    "A cursor used for pagination"
     cursor: ID!
 
-    # The character represented by this friendship edge
+    "The character represented by this friendship edge"
     node: Character
   }
 
-  # Information for paginating this connection
+  "Information for paginating this connection"
   type PageInfo {
     startCursor: ID
     endCursor: ID
     hasNextPage: Boolean!
   }
 
-  # Represents a review for a movie
+  "Represents a review for a movie"
   type Review {
-    # The number of stars this review gave, 1-5
+    "The number of stars this review gave, 1-5"
     stars: Int!
 
-    # Comment about the movie
+    "Comment about the movie"
     commentary: String
   }
 
-  # The input object sent when someone is creating a new review
+  "The input object sent when someone is creating a new review"
   input ReviewInput {
-    # 0-5 stars
+    "0-5 stars"
     stars: Int!
 
-    # Comment about the movie, optional
+    "Comment about the movie, optional"
     commentary: String
   }
 
   type Starship {
-    # The ID of the starship
+    "The ID of the starship"
     id: ID!
 
-    # The name of the starship
+    "The name of the starship"
     name: String!
 
-    # Length of the starship, along the longest axis
+    "Length of the starship, along the longest axis"
     length(unit: LengthUnit = METER): Float
   }