Skip to content

Commit 24a3e5d

Browse files
committed
edits
1 parent e0cc9a7 commit 24a3e5d

File tree

1 file changed

+16
-19
lines changed

1 file changed

+16
-19
lines changed

website/pages/en/network/developing.mdx

Lines changed: 16 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
title: Developing
33
---
44

5-
Learn developer fundamentals and review the basics of a subgraph’s lifecycle. To start coding right away and build on The Graph, go to [Developer Quick Start](/quick-start/).
5+
To start coding right away and build on The Graph, go to [Developer Quick Start](/quick-start/).
66

77
## Overview
88

@@ -17,11 +17,11 @@ On The Graph, you can:
1717

1818
- [GraphQL](https://graphql.org/learn/) is the query language for APIs and a runtime for executing those queries with your existing data. The Graph uses GraphQL to query subgraphs.
1919

20-
### Developer Capabilities
20+
### Developer Actions
2121

2222
- Query subgraphs built by other developers in [The Graph Network](https://thegraph.com/explorer) and integrate them into your own dapps.
2323
- Create custom subgraphs to fulfill specific data needs, allowing improved scalability and flexibility for other developers.
24-
- Deploy, publish, and signal your subgraphs within The Graph Network.
24+
- Deploy, publish and signal your subgraphs within The Graph Network.
2525

2626
## Subgraph Specifics
2727

@@ -37,57 +37,54 @@ A subgraph primarily consists of the following files:
3737

3838
Learn the detailed specifics to [create a subgraph](/developing/creating-a-subgraph/).
3939

40-
### Subgraph Lifecycle
40+
## Subgraph Lifecycle
4141

42-
Here is a general view of a subgraph’s lifecycle:
42+
Here is a general overview of a subgraph’s lifecycle:
4343

4444
![Subgraph Lifecycle](/img/subgraph-lifecycle.png)
4545

46-
### Context for Subgraph Development
46+
### Build locally
4747

4848
Great subgraphs start with a local development environment and unit tests. Developers use [Graph CLI](https://github.com/graphprotocol/graph-tooling/tree/main/packages/cli), a command-line interface tool for building and deploying subgraphs in The Graph. They can also use [Graph TypeScript](/developing/graph-ts/) and [Matchstick](/developing/unit-testing-framework/) to create robust subgraphs that deploy to The Graph Network.
4949

50-
## Deploy to Subgraph Studio
50+
### Deploy to Subgraph Studio
5151

5252
Once defined, a subgraph can be [deployed to Subgraph Studio](/deploying/deploying-a-subgraph-to-studio/). In Subgraph Studio, you can do the following:
5353

5454
- Use its staging environment to index the deployed subgraph and make it available for review.
5555
- Verify that your subgraph doesn't have any indexing errors and works as expected.
5656

57-
## Publish to the Network
57+
### Publish to the Network
5858

59-
When you are happy with your subgraph, you can put it into production and [publish it](/publishing/publishing-a-subgraph/) to The Graph Network. This ensures Indexers can index it.
59+
When you're happy with your subgraph, you can put it into production and [publish it](/publishing/publishing-a-subgraph/) to The Graph Network. This ensures Indexers can index it.
6060

6161
- This is an on-chain action, which registers the subgraph and makes it discoverable by Indexers.
6262
- Published subgraphs have a corresponding NFT, which defines the ownership of the subgraph. You can [transfer the subgraph's ownership](/managing/transfer-and-deprecate-a-subgraph/) by sending the NFT.
6363
- Published subgraphs have associated metadata, which provides other network participants with useful context and information.
6464

65-
## Add Curation Signal for Indexing
65+
### Add Curation Signal for Indexing
6666

6767
Published subgraphs are unlikely to be picked up by Indexers without curation signal. To encourage indexing you should add signal to your subgraph. Learn more about signaling and [curating](/network/curating/) on The Graph.
6868

69-
### What is signal?
69+
#### What is signal?
7070

71-
- Signal is locked GRT associated with a given subgraph. It indicates to indexers that a given subgraph will receive query volume and it contributes to the indexing rewards available for processing it.
71+
- Signal is locked GRT associated with a given subgraph. It indicates to Indexers that a given subgraph will receive query volume and it contributes to the indexing rewards available for processing it.
7272
- Third party Curators may also signal on a given subgraph, if they deem the subgraph likely to drive query volume.
7373

74-
## Querying & Application Development
74+
### Querying & Application Development
7575

7676
Once a subgraph has been processed by Indexers and is ready to [query](/querying/querying-the-graph/), developers can start using their subgraph in their dapps.
7777

7878
- When a query is made, The Graph Network selects an Indexer who has processed the subgraph to serve that query. Query fees are paid in GRT.
7979
- Developers must generate an API key and fund it with GRT to make queries, which can be done in [Subgraph Studio](https://thegraph.com/studio/).
80-
- Developers can set a maximum query fee, in order to control their costs, and limit their API key to a given subgraph or origin domain.
81-
- Subgraph Studio provides API key usage data.
82-
- Developers can express an Indexer preference to the gateway, for example preferring Indexers whose query response is faster, or whose data is most up to date. These controls are set in Subgraph Studio.
8380

84-
## Updating Subgraphs
81+
### Updating Subgraphs
8582

8683
To update your subgraph with bug fixes or new functionalities, initiate a transaction to point it to the new version. You can deploy new versions of your subgraphs to [Subgraph Studio](https://thegraph.com/studio/) for development and testing.
8784

8885
- If you selected "auto-migrate" when you applied the signal, updating the subgraph will migrate any signal to the new version and incur a migration tax.
8986
- This signal migration should prompt Indexers to start indexing the new version of the subgraph, so it should soon become available for querying.
9087

91-
## Deprecating & Transferring Subgraphs
88+
### Deprecating & Transferring Subgraphs
9289

93-
If you no longer need a published subgraph, you can deprecate or transfer a subgraph. Deprecating a subgraph returns any signaled GRT to [Curators](/network/curating/). To deprecate or transfer a subgraph, check out [this guide](/managing/transfer-and-deprecate-a-subgraph/#deprecating-a-subgraph).
90+
If you no longer need a published subgraph, you can [deprecate or transfer a subgraph](managing/transfer-and-deprecate-a-subgraph/). Deprecating a subgraph returns any signaled GRT to [Curators](/network/curating/). To deprecate or transfer a subgraph, check out [this guide](/managing/transfer-and-deprecate-a-subgraph/#deprecating-a-subgraph).

0 commit comments

Comments
 (0)