Studio README questions

[charles-hill-work]

1. What flavor of markdown is used? Can we get a link to the doc's so that we know what syntax is available?
2. How do we embed Variables with our GQL, so that clicking Open in Explorer (play button) includes a fully working sample?

[cheapsteak]

1. We're currently using https://www.npmjs.com/package/markdown-to-jsx, but can't commit to not switching away from it later (there's a potential that we might switch to remark)
2. Good question 💭 do you have ideas on what that might look like? (specifically where might be a good place to provide the variables)

[cheapsteak]

oo we might have a different way of providing variables, hang tight for a bit 🙏 (~ a week)

[charles-hill-work]

Right now, we're including our sample variables as a json code block below the query. My best idea so far is it could be included in the same block as the graphql, using a special comment syntax to differentiate the two sections

query something($input: String!) {
  resource(input: $input): {
    name
  }
}
# Variables
{
  "input": "something"
}

[cheapsteak]

Would the newly released operation collections solve for providing READMEs with variables?

[charles-hill-work]

I think so, yes! Links for the win