README and package.json updates

README.md

@@ -0,0 +1 @@
+packages/schema/README.md

packages/extend/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@graphql-ts/extend",
   "version": "1.0.0",
+  "description": "Utilities to extend existing GraphQL schemas with @graphql-ts/schema",
   "main": "dist/graphql-ts-extend.cjs.js",
   "module": "dist/graphql-ts-extend.esm.js",
   "exports": {

packages/schema/README.md

@@ -0,0 +1,38 @@
+# @graphql-ts/schema
+
+`@graphql-ts/schema` is a thin wrapper around
+[GraphQL.js](https://github.com/graphql/graphql-js) providing type-safety for
+constructing GraphQL Schemas while avoiding type-generation, [declaration merging](https://www.typescriptlang.org/docs/handbook/declaration-merging.html)
+and [decorators](https://www.typescriptlang.org/docs/handbook/decorators.html).
+
+```ts
+import { graphql } from "@graphql-ts/schema";
+import { GraphQLSchema, graphql as runGraphQL } from "graphql";
+
+const Query = graphql.object()({
+  name: "Query",
+  fields: {
+    hello: graphql.field({
+      type: graphql.String,
+      resolve() {
+        return "Hello!";
+      },
+    }),
+  },
+});
+
+const schema = new GraphQLSchema({
+  query: Query.graphQLType,
+});
+
+runGraphQL({
+  source: `
+    query {
+      hello
+    }
+  `,
+  schema,
+}).then((result) => {
+  console.log(result);
+});
+```

packages/schema/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@graphql-ts/schema",
   "version": "0.6.0",
+  "description": "Type-safety for constructing GraphQL schemas in TypeScript",
   "main": "dist/graphql-ts-schema.cjs.js",
   "module": "dist/graphql-ts-schema.esm.js",
   "exports": {