diff --git a/README.md b/README.md index f660b9af86..75e07b1066 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,18 @@ # Source Repository for graphql.org -This repository contains the source code of https://graphql.org website. +This repository contains the source code for the [GraphQL website](https://graphql.org). -## Contributing +> You can find more discussions on the [#website channel on the GraphQL Slack](https://graphql.slack.com/messages/website/). [Get your invite here!](https://graphql-slack.herokuapp.com/) -Check out our [contributing guide](./CONTRIBUTING.md) for detailed instructions for how to make changes to graphql.org 🎉 \ No newline at end of file + +A brief overview: **GraphQL** is a query language for APIs and a runtime for fulfilling those queries with your existing data. It provides a complete and understandable description of the data in your API, gives clients the power to ask for exactly what they need, and enables powerful developer tools. The [specification](https://spec.graphql.org/) is open source and governed by the [GraphQL Foundation](https://foundation.graphql.org/). + +## Documentation +- [Site](https://graphql.org/) +- [Reference documentation](https://graphql.org/learn/) +- [Language support, tools, and services](https://graphql.org/code/) +- [Frequently Asked Questions (FAQ)](https://graphql.org/faq/) +- [Community resources](https://graphql.org/community/) + +## How to contribute +Check out our [contributing guide](./CONTRIBUTING.md) for detailed instructions on how to make changes to the GraphQL website 🎉