diff --git a/README.md b/README.md
index 2aa268b4..9a7ba6d4 100644
--- a/README.md
+++ b/README.md
@@ -7,7 +7,9 @@
 
 The Swift implementation for GraphQL, a query language for APIs created by Facebook.
 
-Looking for help? Find resources [from the community](http://graphql.org/community/).
+This repo is a Swift port of the JavaScript reference implementation. To create GraphQL schemas more easily, use [graphql-generator](https://github.com/GraphQLSwift/graphql-generator) or [Graphiti](https://github.com/GraphQLSwift/Graphiti), and to expose your schema through HTTP, check out [graphql-vapor](https://github.com/GraphQLSwift/graphql-vapor) or [graphql-hummingbird](https://github.com/GraphQLSwift/graphql-hummingbird)
+
+Looking for help? Find resources [from the GraphQL community](http://graphql.org/community/).
 
 ## Usage
 
@@ -34,9 +36,6 @@ let schema = try GraphQLSchema(
 
 For more complex schema examples see the test files.
 
-This repo only contains the core GraphQL implementation and does not focus on the ease of schema creation. For a better experience
-when creating your GraphQL schema use [Graphiti](https://github.com/GraphQLSwift/Graphiti).
-
 ### Execution
 
 Once a schema has been defined queries may be executed against it using the global `graphql` function:
@@ -133,7 +132,7 @@ swiftformat .
 ```
 
 Most of this repo mirrors the structure of
-(the canonical GraphQL implementation written in Javascript/Typescript)[https://github.com/graphql/graphql-js]. If there is any feature
+[the canonical GraphQL implementation written in Javascript/Typescript](https://github.com/graphql/graphql-js). If there is any feature
 missing, looking at the original code and "translating" it to Swift works, most of the time. For example:
 
 ### Swift