Add definitions to the style guide (#1137)

Co-authored-by: Benjie <[email protected]>
graphql · Feb 26, 2025 · 60a0677 · 60a0677
1 parent a1c025f
commit 60a0677
Showing 1 changed file with 9 additions and 0 deletions.
diff --git a/STYLE_GUIDE.md b/STYLE_GUIDE.md
@@ -82,3 +82,12 @@ MyAlgorithm(argOne, argTwo):
     - Let {something} be {true}.
 - Return {something}.
 ```
+
+## Definitions
+
+For important terms, use
+[Spec Markdown definition paragraphs](https://spec-md.com/#sec-Definition-Paragraph).
+
+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.