chore(docs): add graphql docs generation

[hiemanshu]

Description

Uses spectaql to generate graphql docs. requires a global install of spectaql

Motivation and Context

Provides a clean looking (and public facing possibly) interface for GraphQL API Docs.

How Has This Been Tested?

Screenshots (if appropriate):

Documentation Changes

Checklist:

• My change requires a change to the documentation.
• I have included updates for the documentation accordingly.

[lediur]

What does adding descriptions / examples to the schema look like? Would that get merged in by codegen from the individual schemas?

I would love to see a worked example in this PR with some explanations / examples so we know a little bit about how much work it takes to enhance the generated documentation with developer commentary.

[bchrobot]

I second what Derrick asked above.

I think we should also be explicit about who the intended audience is for these docs, how they'll use it, and how the GraphQL documentation might connect or relate to other documentation (user docs, docs of the REST endpoints, schema docs, etc.). Regardless, I would rather see this as a local dev dependency invoked by a JS script than a global, and I would rather the docs be generated locally (via commands outlined in the README) or during a CI docs publication versus being checked in.