Skip to content

Commit

Permalink
remove tone of voice
Browse files Browse the repository at this point in the history
  • Loading branch information
martinbonnin committed Feb 25, 2025
1 parent 1e198e6 commit 6578a30
Showing 1 changed file with 0 additions and 13 deletions.
13 changes: 0 additions & 13 deletions STYLE_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -90,16 +90,3 @@ For important terms, use [Spec Markdown definition paragraphs](https://spec-md.c
Definition paragraphs start with `::` and add the matching italicized term to the
[specification index](https://spec.graphql.org/draft/#index), making it easy to
reference them.

## Tone of voice

The GraphQL specification is a reference document and should use neutral and
descriptive tone of voice.

Favor the present tense. The present tense is usually clearer and shorter:

✅ Present: The client then sends a request to the server.
❌ Future: The client will then send a request to the server.

Avoid repetition. Repetition adds more cognitive load and possibilities for different
parts of the specification to diverge in their meaning.

0 comments on commit 6578a30

Please sign in to comment.