deploy: b1a23de

Author: github-actions[bot]

draft/index.html

@@ -1541,7 +1541,7 @@ <h2 data-source="spec/Section%203%20--%20Type%20System.md#L30"><span class="spec
 <section id="sec-Type-System-Descriptions" secid="3.2">
 <h2 data-source="spec/Section%203%20--%20Type%20System.md#L53"><span class="spec-secid" title="link to this section"><a href="#sec-Type-System-Descriptions">3.2</a></span>Type System Descriptions</h2>
 <p data-source="spec/Section%203%20--%20Type%20System.md#L55-L57">Documentation is a first-class feature of GraphQL type systems, written immediately alongside definitions in a <span class="spec-nt"><a href="#TypeSystemDocument" data-name="TypeSystemDocument">TypeSystemDocument</a></span> and made available via introspection.</p>
-<p data-source="spec/Section%203%20--%20Type%20System.md#L59-L62"><a href="#sec-Descriptions">Descriptions</a> allow GraphQL service designers to easily provide documentation which remains consistent with the capabilities of a GraphQL service. Descriptions provided as Markdown (as specified by <a href="https://commonmark.org/">CommonMark</a>) for every definition in a type system.</p>
+<p data-source="spec/Section%203%20--%20Type%20System.md#L59-L62"><a href="#sec-Descriptions">Descriptions</a> allow GraphQL service designers to easily provide documentation which remains consistent with the capabilities of a GraphQL service. Descriptions should be provided as Markdown (as specified by <a href="https://commonmark.org/">CommonMark</a>) for every definition in a type system.</p>
 <p data-source="spec/Section%203%20--%20Type%20System.md#L64-L66">GraphQL schema and all other definitions (e.g. types, fields, arguments, etc.) which can be described should provide a <span class="spec-nt"><a href="#Description" data-name="Description">Description</a></span> unless they are considered self descriptive.</p>
 <p data-source="spec/Section%203%20--%20Type%20System.md#L68">As an example, this simple GraphQL schema is well described:</p>
 <pre id="example-916f4" class="spec-example" data-language="graphql" data-source="spec/Section%203%20--%20Type%20System.md#L70-L110"><a href="#example-916f4">Example № 37</a><code><span class="token description string">"""<span class="token language-markdown">