Document directives are not special

Author: langpavel

spec/Appendix B -- Grammar Summary.md

@@ -91,17 +91,13 @@ lines and uniform indentation with {BlockStringValue()}.
 
 ## Document
 
-Document : Definition+
+Document : Directives[Const]? Definition+
 
 Definition :
-  - DocumentDirective
   - ExecutableDefinition
   - TypeSystemDefinition
   - TypeSystemExtension
 
-DocumentDirective :
-  - Directive[Const]
-
 ExecutableDefinition :
   - OperationDefinition
   - FragmentDefinition

spec/Section 2 -- Language.md

@@ -169,10 +169,9 @@ characters to support interoperation with as many other systems as possible.
 
 ## Document
 
-Document : Definition+
+Document : Directives[Const]? Definition+
 
 Definition :
-  - DocumentDirective
   - ExecutableDefinition
   - TypeSystemDefinition
   - TypeSystemExtension
@@ -1095,24 +1094,3 @@ and operations.
 
 As future versions of GraphQL adopt new configurable execution capabilities,
 they may be exposed via directives.
-
-
-## Document Directives
-
-DocumentDirective :
-  - Directive[Const]
-
-{DocumentDirective} is special kind of {Definition} and should be handled
-on AST level by implementation in similar way like {TypeSystemDefinition}
-or {ExecutableDefinition}.
-
-Documents of any kind may contain zero or more {DocumentDirective}s.
-Same directive may be repeated multiple times at document level:
-
-```graphql example
-@import(from: "./common")
-@import(from: "./user")
-```
-
-Unknown directives may be ignored, but it is recommended for services to fail
-if directive is not recognized.

spec/Section 3 -- Type System.md

@@ -1672,14 +1672,6 @@ directive @example on
   | INLINE_FRAGMENT
 ```
 
-Special directive location `DOCUMENT` allows free top level directives:
-
-```graphql example
-directive @import(from: String! only:[String!]) on DOCUMENT
-
-@import(from: "./common.graphql")
-```
-
 Directives can also be used to annotate the type system definition language
 as well, which can be a useful tool for supplying additional metadata in order
 to generate GraphQL execution services, produce client generated runtime code,