Skip to content

Commit 3bbb9e9

Browse files
unicodeveloperpeggyrayzis
authored andcommitted
Remove some unecessary items
1 parent 6acc6a1 commit 3bbb9e9

1 file changed

Lines changed: 12 additions & 13 deletions

File tree

docs/source/tutorial/production.md

Lines changed: 12 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -14,17 +14,17 @@ You need the following before deployment:
1414

1515
Now looks for a `start` script in the `package.json` file to start the app. Once the script is present, Now will be able to start the app.
1616

17-
Go ahead and run the `now` command from the root directory of the app.
17+
Go ahead and run the `now` command from the root directory of the app to deploy our app to Now.
1818

1919
```bash
2020
$ now
2121
```
2222

23-
The `now` command immediately deploys your graph API to the cloud and returns the hosted URL. The returned URL comes in this format: `<NOW_APP_NAME>.now.sh`.
23+
The `now` command immediately deploys our graph API to the cloud and returns the hosted URL. The returned URL comes in this format: `<NOW_APP_NAME>.now.sh`.
2424

25-
You can now query your graph service at `<NOW_APP_NAME>.now.sh/graphql`.
25+
You can now query the graph service at `<NOW_APP_NAME>.now.sh/graphql`.
2626

27-
Now also supports direct deployment from a GitHub repository. If your graph API is publicly available on GitHub, you can deploy it via the `now` command like so:
27+
**Note:** Now also supports direct deployment from a GitHub repository. If your graph API is publicly available on GitHub, you can deploy it via the `now` command like so:
2828

2929
```bash
3030
now <github-username>/<repository-name>
@@ -36,25 +36,27 @@ Safely evolving your schema overtime requires a lot of developer efforts in ensu
3636

3737
[Apollo Engine](https://engine.apollographql.com), provides deep insights into your graph layer that enables you to understand, optimize, and control your graph service in production with confidence.
3838

39-
Once you publish your schema to Apollo Engine, it becomes the basis for comparison for validating future schemas and avoiding breaking changes. Therefore, a schema should be re-published to Apollo Engine each time a new schema is deployed.
39+
Once we publish our schema to Apollo Engine, it becomes the basis for comparison for validating future schemas and avoiding breaking changes. Therefore, a schema should be re-published to Apollo Engine each time a new schema is deployed.
4040

4141
Go ahead and install the `apollo` CLI via npm:
4242

4343
```bash
4444
npm install --global apollo
4545
```
4646

47-
To publish a schema, start your GraphQL server and run the command below:
47+
To publish our schema to Apollo Engine, we need an API key.
48+
49+
An API key can be obtained from a graph service’s _Settings_ menu within the [Apollo Engine dashboard](https://engine.apollographql.com).
50+
51+
Now start your GraphQL server and run the command below:
4852

4953
```bash
5054
apollo schema:publish --key="<API_KEY>" --endpoint="https://<now_app_name>.now.sh/graphql"
5155
```
5256

53-
**Note:** An API key can be obtained from a graph service’s _Settings_ menu within the [Apollo Engine dashboard](https://engine.apollographql.com).
54-
5557
The `--endpoint` flag should be set to the URL of a running GraphQL server.
5658

57-
Every time your schema is updated, run the `apollo schema:publish` command so that Apollo Engine can provide a history of schema changes. This allows everyone on your team to know when new types and fields are added or removed. Apollo Engine also provides a reference to the commits that introduced changes to the schema.
59+
Every time the schema is updated, run the `apollo schema:publish` command so that Apollo Engine can provide a history of schema changes. This allows everyone on your team to know when new types and fields are added or removed. Apollo Engine also provides a reference to the commits that introduced changes to the schema.
5860

5961
To check the difference between the current schema and a newly published schema version, you can run the command below:
6062

@@ -72,9 +74,7 @@ Apollo Engine identifies three categories of changes and report them to the deve
7274

7375
You need a bird's-eye view of your graph's API. Understanding how your schema fields, and queries operates within your graph service opens you to a whole new world of effective optimization and scaling!
7476

75-
In order to get access to your graph's performance metrics, hook up Apollo Server with Engine.
76-
77-
First, get an API key from [Engine](https://engine.apollographql.com). Now, connect to Engine by passing the API key to the Apollo Server constructor:
77+
In order to get access to your graph's performance metrics, hook up Apollo Server with Engine. Connect to Engine by passing the API key to the Apollo Server constructor:
7878

7979
_src/index.js_
8080

@@ -100,7 +100,6 @@ Apollo Engine provides all of the following features highlighted below:
100100
* **Schema Explorer:** With Engine's powerful schema registry, you can quickly explore all the types and fields in your schema with usage statistics on each field. This metric makes you understand the cost of a field. How expensive is a field? Is a certain field in so much demand?
101101
* **Schema history:** Apollo Engine’s schema history allows developers to confidently iterate a graph's schema by validating the new schema against field-level usage data from the previous schema. This empowers developers to avoid breaking changes by providing insights into which clients will be broken by a new schema.
102102
* **Performance Analytics:** Fine-grained insights into every field, resolvers and operations of your graph's execution.
103-
* **Query tracing:** The _Trace view_ in the Engine UI allows you to look at a detailed breakdown of the execution of one query, with timing for every resolver.
104103
* **Performance alerts:** You can configure notifications to be sent to various channels like Slack, and PagerDuty. Apollo Engine can be set to send alerts when a request rate, duration or error rate exceeds a certain threshold. You can effectively monitor everything going on in your graph's service.
105104

106105
The [Engine](https://www.apollographql.com/docs/engine/) guide provides detailed instructions on how Apollo Engine works and the setup for any type for performance or usage analytics.

0 commit comments

Comments
 (0)