[
https://issues.apache.org/jira/browse/SLING-9479?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17123795#comment-17123795
]
Bertrand Delacretaz commented on SLING-9479:
--------------------------------------------
BTW the field descriptions spec is at
http://spec.graphql.org/June2018/#sec-Descriptions
> GraphQL fetcher comments convert to headings in GraphiQL docs
> -------------------------------------------------------------
>
> Key: SLING-9479
> URL: https://issues.apache.org/jira/browse/SLING-9479
> Project: Sling
> Issue Type: Bug
> Components: GraphQL
> Reporter: Bertrand Delacretaz
> Assignee: Bertrand Delacretaz
> Priority: Minor
>
> The GraphQL core currently uses comments like this to map fields to
> DataFetchers:
> {code}
> ## fetch:samples/seeAlso
> {code}
> A common tool to look at those schemas is GraphiQL, which converts such
> comments to headings, considering them to be Markdown.
> We should switch to a less intrusive marker that converts nicely to Markdown.
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
