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