Merge branch 'source' into migrate-foundation-website-content

Author: brianwarner

.gitignore

@@ -68,3 +68,6 @@ yarn-error.log
 .pnp.js
 # Yarn Integrity file
 .yarn-integrity
+
+# Swap files
+*.swp

src/content/code/language-support/flutter/client/ferry.md

@@ -0,0 +1,8 @@
+---
+name: Ferry
+description: Ferry is a simple, powerful GraphQL Client for Flutter and Dart.
+url: https://ferrygraphql.com/
+github: gql-dart/ferry
+---
+
+

src/content/code/language-support/javascript/tools/graphql-middleware.md

@@ -0,0 +1,65 @@
+---
+name: GraphQLMiddleware
+description: Split up your GraphQL resolvers in middleware functions.
+url: https://github.com/maticzav/graphql-middleware
+github: maticzav/graphql-middleware
+npm: "graphql-middleware"
+---
+
+GraphQL Middleware is a schema wrapper which allows you to manage additional functionality across multiple resolvers efficiently.
+
+## Features
+
+💡 Easy to use: An intuitive, yet familiar API that you will pick up in a second.
+💪 Powerful: Allows complete control over your resolvers (Before, After).
+🌈 Compatible: Works with any GraphQL Schema.
+
+## Example
+
+```ts
+const { ApolloServer } = require('apollo-server')
+const { makeExecutableSchema } = require('@graphql-tools/schema')
+
+const typeDefs = `
+type Query {
+  hello(name: String): String
+  bye(name: String): String
+}
+`
+const resolvers = {
+  Query: {
+    hello: (root, args, context, info) => {
+      console.log(`3. resolver: hello`)
+      return `Hello ${args.name ? args.name : 'world'}!`
+    },
+    bye: (root, args, context, info) => {
+      console.log(`3. resolver: bye`)
+      return `Bye ${args.name ? args.name : 'world'}!`
+    },
+  },
+}
+
+const logInput = async (resolve, root, args, context, info) => {
+  console.log(`1. logInput: ${JSON.stringify(args)}`)
+  const result = await resolve(root, args, context, info)
+  console.log(`5. logInput`)
+  return result
+}
+
+const logResult = async (resolve, root, args, context, info) => {
+  console.log(`2. logResult`)
+  const result = await resolve(root, args, context, info)
+  console.log(`4. logResult: ${JSON.stringify(result)}`)
+  return result
+}
+
+const schema = makeExecutableSchema({ typeDefs, resolvers })
+
+const schemaWithMiddleware = applyMiddleware(schema, logInput, logResult)
+
+const server = new ApolloServer({
+  schema: schemaWithMiddleware,
+})
+
+await server.listen({ port: 8008 })
+```

src/content/code/language-support/javascript/tools/graphql-shield.md

@@ -0,0 +1,60 @@
+---
+name: GraphQLShield
+description: A GraphQL tool to ease the creation of permission layer.
+url: https://github.com/maticzav/graphql-shield
+github: maticzav/graphql-shield
+npm: "graphql-shield"
+---
+
+GraphQL Shield helps you create a permission layer for your application. Using an intuitive rule-API, you'll gain the power of the shield engine on every request and reduce the load time of every request with smart caching. This way you can make sure your application will remain quick, and no internal data will be exposed.
+
+```ts
+import { rule, shield, and, or, not } from 'graphql-shield'
+
+// Rules
+
+const isAuthenticated = rule({ cache: 'contextual' })(
+  async (parent, args, ctx, info) => {
+    return ctx.user !== null
+  },
+)
+
+const isAdmin = rule({ cache: 'contextual' })(
+  async (parent, args, ctx, info) => {
+    return ctx.user.role === 'admin'
+  },
+)
+
+const isEditor = rule({ cache: 'contextual' })(
+  async (parent, args, ctx, info) => {
+    return ctx.user.role === 'editor'
+  },
+)
+
+// Permissions
+
+const permissions = shield({
+  Query: {
+    frontPage: not(isAuthenticated),
+    fruits: and(isAuthenticated, or(isAdmin, isEditor)),
+    customers: and(isAuthenticated, isAdmin),
+  },
+  Mutation: {
+    addFruitToBasket: isAuthenticated,
+  },
+  Fruit: isAuthenticated,
+  Customer: isAdmin,
+})
+
+// Server
+
+const server = new GraphQLServer({
+  typeDefs,
+  resolvers,
+  middlewares: [permissions],
+  context: (req) => ({
+    ...req,
+    user: getUser(req),
+  }),
+})
+```

src/content/code/language-support/swift-objective-c-ios/client/swift-graphql.md

@@ -0,0 +1,49 @@
+---
+name: SwiftGraphQL
+description: A GraphQL client that lets you forget about GraphQL.
+url: https://github.com/maticzav/swift-graphql
+github: maticzav/swift-graphql
+---
+
+
+SwiftGraphQL is a Swift code generator and a lightweight GraphQL client. It lets you create queries using Swift, and guarantees that every query you create is valid.
+
+The library is centered around three core principles:
+
+🚀 If your project compiles, your queries work.
+🦉 Use Swift in favour of GraphQL wherever possible.
+🌳 Your application model should be independent of your schema.
+
+Here's a short preview of the SwiftGraphQL code
+
+```swift
+import SwiftGraphQL
+
+// Define a Swift model.
+struct Human: Identifiable {
+    let id: String
+    let name: String
+    let homePlanet: String?
+}
+
+// Create a selection.
+let human = Selection.Human {
+    Human(
+        id: try $0.id(),
+        name: try $0.name(),
+        homePlanet: try $0.homePlanet()
+    )
+}
+
+// Construct a query.
+let query = Selection.Query {
+    try $0.humans(human.list)
+}
+
+// Perform the query.
+send(query, to: "http://swift-graphql.heroku.com") { result in
+    if let data = try? result.get() {
+        print(data) // [Human]
+    }
+}
+```

src/content/learn/Introduction.md

@@ -7,11 +7,18 @@ permalink: /learn/
 next: /learn/queries/
 ---
 
-> Learn about GraphQL, how it works, and how to use it in this series of articles. Looking for documentation on how to build a GraphQL service? There are libraries to help you implement GraphQL in [many different languages](/code/). For an in-depth learning experience with practical tutorials, visit the [How to GraphQL](https://www.howtographql.com) fullstack tutorial website. We have also partnered with edX to create a free online course, [Exploring GraphQL: A Query Language for APIs](https://www.edx.org/course/exploring-graphql-a-query-language-for-apis).
+> Learn about GraphQL, how it works, and how to use it. Looking for documentation on how to build a GraphQL service? 
+> There are libraries to help you implement GraphQL in [many different languages](/code/). For an in-depth learning experience 
+> with practical tutorials, see [How to GraphQL](https://www.howtographql.com). Check out the 
+> free online course, 
+> [Exploring GraphQL: A Query Language for APIs](https://www.edx.org/course/exploring-graphql-a-query-language-for-apis).
 
-GraphQL is a query language for your API, and a server-side runtime for executing queries by using a type system you define for your data. GraphQL isn't tied to any specific database or storage engine and is instead backed by your existing code and data.
+GraphQL is a query language for your API, and a server-side runtime for executing queries using a type system you define for your 
+data. GraphQL isn't tied to any specific database or storage engine and is instead backed by your existing code and data.
 
-A GraphQL service is created by defining types and fields on those types, then providing functions for each field on each type. For example, a GraphQL service that tells us who the logged in user is (`me`) as well as that user's name might look something like this:
+A GraphQL service is created by defining types and fields on those types, then providing functions for each field on each type. 
+For example, a GraphQL service that tells you who the logged in user is (`me`) as well as that user's name might look 
+like this:
 
 ```graphql
 type Query {
@@ -36,9 +43,11 @@ function User_name(user) {
 }
 ```
 
-Once a GraphQL service is running (typically at a URL on a web service), it can receive GraphQL queries to validate and execute. A received query is first checked to ensure it only refers to the types and fields defined, then runs the provided functions to produce a result.
+After a GraphQL service is running (typically at a URL on a web service), it can receive GraphQL queries to validate and execute. 
+The service first checks a query to ensure it only refers to the types and fields defined, and then runs the provided functions 
+to produce a result.
 
-For example the query:
+For example, the query:
 
 ```graphql
 {
@@ -48,7 +57,7 @@ For example the query:
 }
 ```
 
-Could produce the JSON result:
+Could produce the following JSON result:
 
 ```json
 {
@@ -58,4 +67,4 @@ Could produce the JSON result:
 }
 ```
 
-Learn more about GraphQL — the query language, type system, how the GraphQL service works, as well as best practices for using GraphQL in the articles written in this section; they help to solve common problems.
+To learn more, click **Continue Reading**.