At Shopify we have announced the Storefront API, a GraphQL based API that makes our Customer and Checkout objects consumable to API clients as a GraphQL endpoint. GraphQL is a query language for APIs and a runtime for fulfilling those queries with your existing data. GraphQL provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need and nothing more, makes it easier to evolve APIs over time. This talk has evolved from an Unconference session at Write the Docs Portland 2017 and covers our custom tooling, approach to descriptions / conceptual material, and the relationship of our GraphQL docs to the existing developer hub and REST API.