Skip to content

Commit 04fbcae

Browse files
Add tone of voice (#1138)
* add tone of voice * format * fix formating * formatting * remove "repetition" --------- Co-authored-by: Lee Byron <lee@leebyron.com>
1 parent 3c02659 commit 04fbcae

File tree

1 file changed

+13
-0
lines changed

1 file changed

+13
-0
lines changed

STYLE_GUIDE.md

+13
Original file line numberDiff line numberDiff line change
@@ -91,3 +91,16 @@ For important terms, use
9191
Definition paragraphs start with `::` and add the matching italicized term to
9292
the [specification index](https://spec.graphql.org/draft/#index), making it easy
9393
to reference them.
94+
95+
## Tone of voice
96+
97+
The GraphQL specification is a reference document and should use neutral and
98+
descriptive tone of voice.
99+
100+
**Favor the present tense**
101+
102+
The present tense is usually clearer and shorter:
103+
104+
✅ Present: The client then sends a request to the server.
105+
106+
❌ Future: The client will then send a request to the server.

0 commit comments

Comments
 (0)