graphdoc icon indicating copy to clipboard operation
graphdoc copied to clipboard

Attribute not documented

Open andushow opened this issue 5 years ago • 2 comments

Having run grapfdoc, it produced the expected output with the existing types (objects). The output says that the Arguments are not documented; any advice on how to document them ? Clipboard01

andushow avatar Aug 21 '20 05:08 andushow

I found this (Chapter 4.2): https://spec.graphql.org/June2018/#sec-Field-Arguments

"All types in the introspection system provide a description field of type String to allow type designers to publish documentation in addition to capabilities. A GraphQL server may return the description field using Markdown syntax (as specified by CommonMark). Therefore it is recommended that any tool that displays description use a CommonMark‐compliant Markdown renderer."

Is this the field missing (description) ?

andushow avatar Aug 21 '20 06:08 andushow

Yes.

ab-tools avatar Apr 04 '21 08:04 ab-tools