COMDOX-828 Services Schema

[jhadobe]

This PR demonstrates the possibility of having a separately generated GraphQL schema for services.

It includes:

• Catalog Service
• Live Search
• Product Recommendations

Staging: https://developer-stage.adobe.com/commerce/services/graphql/reference/

Sanity check, I see the following queries:

• attributeMetadata
• categories
• productSearch
• products
• recommendations
• refineProduct

These queries match the following services:

• https://developer.adobe.com/commerce/webapi/graphql/schema/catalog-service/queries/
  • categories
  • productSearch
  • products
  • refineProduct
• https://developer.adobe.com/commerce/webapi/graphql/schema/products/queries/
  • recommendations
• https://developer.adobe.com/commerce/webapi/graphql/schema/live-search/queries/
  • attributeMetadata
  • productSearch

[jeff-matthews]

Nice work @jhadobe! 🥇 I made some suggestions based on what I saw in Kevin's migration PR (#71).

@keharper, it might be a good idea to hold off on merging #71 if this PR basically fast tracks our ambitions to eliminate the manually maintained API reference for services. Or perhaps you and Jared should combine efforts if you think the autogenerated content needs to be supplemented with manually written .md. What do you think?

I've noticed that there are some missing descriptions in some of the queries and types. It also looks like there are more types than what we currently have in production, but I'm not sure. It makes me wonder if there are some elements of the schema that should remain private.