From 8fc5d0b13463713915454e6a42bf82ec2f5a9b7b Mon Sep 17 00:00:00 2001
From: Lyndon Maydwell <lyndon@sordina.net>
Date: Thu, 4 Jul 2024 12:33:28 +1000
Subject: [PATCH] README changes

---
 README.md | 32 +++++++++++++++++++++++++++-----
 1 file changed, 27 insertions(+), 5 deletions(-)

diff --git a/README.md b/README.md
index ab11554..f5bc14d 100644
--- a/README.md
+++ b/README.md
@@ -50,8 +50,8 @@ for the purposes of connecting to a GraphQL schema with this connector.
 Once you are operating within a subgraph you can add the GraphQL connector:
 
 ```sh
-ddn subgraph init app
-ddn connector init graphql --hub-connector hasura/graphql
+ddn subgraph init app --dir app --target-supergraph supergraph.local.yaml --target-supergraph supergraph.cloud.yaml
+ddn connector init graphql --subgraph ./app/subgraph.yaml --add-to-compose-file compose.yaml --configure-port 8081 --hub-connector hasura/graphql
 ```
 
 <details>
@@ -166,8 +166,14 @@ Once the connector introspection configuration is updated, you can perform an up
 in order to fetch the schema for use and then add the connector link:
 
 ```sh
-ddn connector introspect --connector graphql # Names have to match?
-ddn connector-link add graphql # Pick another name?
+ddn connector introspect --connector ./app/connector/graphql/connector.local.yaml
+ddn connector-link add graphql --configure-host http://local.hasura.dev:8081 --subgraph app/subgraph.yaml --target-env-file app/.env.app.local
+```
+
+At this point you will want to have your connector running locally if you are performing local development:
+
+```sh
+docker compose up -d --build app_graphql
 ```
 
 
@@ -213,7 +219,7 @@ if there is a public readonly instance of Hasura available for use.
 Track the associated commands (functions/procedures) in your supergraph:
 
 ```sh
-ddn-staging connector-link update graphql --add-all-resources
+ddn-staging connector-link update graphql --subgraph app/subgraph.yaml --env-file app/.env.app.local --add-all-resources
 ```
 
 If you just need to update your existing connector you can run the update command again.
@@ -270,6 +276,22 @@ definition:
       See the `# REMOVE` comments. You will encounter a build error if you
       forget to do this.**
 
+### Testing your Supergraph
+
+You can then build and test your supergraph:
+
+```sh
+ddn supergraph build local --supergraph supergraph.local.yaml --output-dir engine --env-file=app:./app/.env.app.local
+```
+
+Running services locally with docker:
+
+```sh
+docker compose up -d --build
+```
+
+See your docker compose file for information on exposed service ports.
+
 
 ### Replicating specific permissions in models