chore(docs): add graphql docs generation

.eslintignore

@@ -10,3 +10,4 @@ seeds
 dev-tools
 libs/spoke-codegen/src/generated.ts
 libs/spoke-codegen/src/pg-types.ts
+public/**/*

.prettierignore

@@ -11,3 +11,4 @@ CHANGELOG.md
 tsconfig.json
 libs/spoke-codegen/src/generated.ts
 libs/spoke-codegen/src/pg-types.ts
+public/**/*

config.spectaql.yml

@@ -0,0 +1,15 @@
+spectaql:
+  displayAllServers: false
+introspection:
+  removeTrailingPeriodFromDescriptions: false
+  schemaFile: ./src/schema.graphql
+  queryNameStrategy: capitalizeFirst
+  fieldExpansionDepth: 2
+  spectaqlDirective:
+    enable: true
+extensions:
+  graphqlScalarExamples: true
+info:
+  title: Spoke GraphQL API Reference
+  description: v6.20.0-rc.0
+  x-url: https://stagingenv.spokerewired.com/graphql

package.json

@@ -44,7 +44,8 @@
     "dev:codegen:ts": "run-when-changed --watch \"src/schema.graphql\" --watch \"libs/spoke-codegen/src/graphql/**/*.graphql\" --exec \"yarn codegen:ts\"",
     "dev:client-nowrap": "nf start --trim 500 --procfile ./dev-tools/Procfile.dev",
     "util:insert-invite": "babel-node ./dev-tools/insert-invite.js",
-    "util:generate-contacts": "babel-node ./dev-tools/generate-contacts.js"
+    "util:generate-contacts": "babel-node ./dev-tools/generate-contacts.js",
+    "util:graphql-docs": "spectaql -c ./config.spectaql.yml"
   },
   "repository": {
     "type": "git",