Added a description to the pagination arguments. (#330)

src/connection/__tests__/connection-test.js

@@ -189,9 +189,33 @@ describe('connectionDefinition()', () => {
 
       type User {
         name: String
-        friends(after: String, first: Int, before: String, last: Int): FriendConnection
-        friendsForward(after: String, first: Int): UserConnection
-        friendsBackward(before: String, last: Int): UserConnection
+        friends(
+          """Returns the items in the list that come after the specified cursor."""
+          after: String
+
+          """Returns the first n items from the list."""
+          first: Int
+
+          """Returns the items in the list that come before the specified cursor."""
+          before: String
+
+          """Returns the last n items from the list."""
+          last: Int
+        ): FriendConnection
+        friendsForward(
+          """Returns the items in the list that come after the specified cursor."""
+          after: String
+
+          """Returns the first n items from the list."""
+          first: Int
+        ): UserConnection
+        friendsBackward(
+          """Returns the items in the list that come before the specified cursor."""
+          before: String
+
+          """Returns the last n items from the list."""
+          last: Int
+        ): UserConnection
       }
 
       """A connection to a list of items."""

src/connection/connection.js

@@ -21,9 +21,12 @@ import type {
 export const forwardConnectionArgs: GraphQLFieldConfigArgumentMap = {
   after: {
     type: GraphQLString,
+    description:
+      'Returns the items in the list that come after the specified cursor.',
   },
   first: {
     type: GraphQLInt,
+    description: 'Returns the first n items from the list.',
   },
 };
 
@@ -34,9 +37,12 @@ export const forwardConnectionArgs: GraphQLFieldConfigArgumentMap = {
 export const backwardConnectionArgs: GraphQLFieldConfigArgumentMap = {
   before: {
     type: GraphQLString,
+    description:
+      'Returns the items in the list that come before the specified cursor.',
   },
   last: {
     type: GraphQLInt,
+    description: 'Returns the last n items from the list.',
   },
 };