revert

src/language/parser.ts

@@ -88,7 +88,8 @@ export interface ParseOptions {
    * contained in a fragment definition. They'll be represented in the
    * `variableDefinitions` field of the FragmentDefinitionNode.
    *
-   * The syntax is identical to normal, query-defined variables.
+   * The syntax is identical to normal, query-defined variables. For example:
+   *
    * ```graphql
    * fragment A($var: Boolean = false) on T {
    *   ...
@@ -203,9 +204,7 @@ export class Parser {
   // Implements the parsing rules in the Document section.
 
   /**
-   * ```
    * Document : Definition+
-   * ```
    */
   parseDocument(): DocumentNode {
     return this.node<DocumentNode>(this._lexer.token, {
@@ -219,7 +218,6 @@ export class Parser {
   }
 
   /**
-   * ```
    * Definition :
    *   - ExecutableDefinition
    *   - TypeSystemDefinition
@@ -228,7 +226,6 @@ export class Parser {
    * ExecutableDefinition :
    *   - OperationDefinition
    *   - FragmentDefinition
-   * ```
    */
   parseDefinition(): DefinitionNode {
     if (this.peek(TokenKind.NAME)) {
@@ -263,11 +260,9 @@ export class Parser {
   // Implements the parsing rules in the Operations section.
 
   /**
-   * ```
    * OperationDefinition :
    *  - SelectionSet
    *  - OperationType Name? VariableDefinitions? Directives? SelectionSet
-   * ```
    */
   parseOperationDefinition(): OperationDefinitionNode {
     const start = this._lexer.token;
@@ -297,9 +292,7 @@ export class Parser {
   }
 
   /**
-   * ```
    * OperationType : one of query mutation subscription
-   * ```
    */
   parseOperationType(): OperationTypeNode {
     const operationToken = this.expectToken(TokenKind.NAME);
@@ -316,9 +309,7 @@ export class Parser {
   }
 
   /**
-   * ```
    * VariableDefinitions : ( VariableDefinition+ )
-   * ```
    */
   parseVariableDefinitions(): Array<VariableDefinitionNode> {
     return this.optionalMany(
@@ -329,9 +320,7 @@ export class Parser {
   }
 
   /**
-   * ```
    * VariableDefinition : Variable : Type DefaultValue? Directives[Const]?
-   * ```
    */
   parseVariableDefinition(): VariableDefinitionNode {
     return this.node<VariableDefinitionNode>(this._lexer.token, {

src/type/definition.ts

@@ -1093,7 +1093,7 @@ export interface GraphQLInterfaceTypeExtensions {
  * all types, as well as a function to determine which type is actually used
  * when the field is resolved.
  *
- * example
+ * Example
  * ```ts
  * const EntityType = new GraphQLInterfaceType({
  *   name: 'Entity',