We read every piece of feedback, and take your input very seriously.
To see all available qualifiers, see our documentation.
1 parent e9ac8c8 commit ac3da61Copy full SHA for ac3da61
STYLE_GUIDE.md
@@ -82,3 +82,16 @@ MyAlgorithm(argOne, argTwo):
82
- Let {something} be {true}.
83
- Return {something}.
84
```
85
+
86
+## Tone of voice
87
88
+The GraphQL specification is a reference document and should use neutral and
89
+descriptive tone of voice.
90
91
+Favor the present tense. The present tense is usually clearer and shorter:
92
93
+✅ Present: The client then sends a request to the server.
94
+❌ Future: The client will then send a request to the server.
95
96
+Avoid repetition. Repetition adds more cognitive load and possibilities for different
97
+parts of the specification to diverge in their meaning.
0 commit comments