Я документирую все свои типы, поля и параметры в своей схеме (SDL), включая Query и Mutation вверху, но я не могу понять, как добавить отдельный фрагмент документации для верхнего уровня всей схемы. .
Я не уверен, что это спецификация или инструментарий - например, Apollo позволяет мне писать schema { }, но ничего не помещать внутрь него или документации перед ним.
И в документах нет примеров этого, особенно в https://graphql.github.io/graphql-spec/June2018/#sec-Описания, который показывает «хорошо описанную» схему без строки документа верхнего уровня.
Это что-то, что спецификация не распространяется, или только инструменты?


В отличие от типов, SchemaDefinitionспец. не содержит Description. В __Schemaтип самоанализа также нет поля description. Таким образом, невозможно установить или получить описание всей схемы.
Однако это предстоящая функция.