diff --git a/README.md b/README.md index 2a1c4c1556..2da4335f60 100644 --- a/README.md +++ b/README.md @@ -1,31 +1,66 @@ -# Source Repository for graphql.org +# Source Repository for GraphQL.org This repository contains the source code for the [GraphQL website](https://graphql.org). -> 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/) +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/). -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/). +## Table of Contents + +- [Overview](#overview) +- [Documentation](#documentation) +- [Deployment](#deployment) +- [How to Contribute](#how-to-contribute) +- [CLA Process](#cla-process) +- [Financial Support](#financial-support) + +## 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, +- support for powerful developer tooling, and +- precise querying, which offers several benefits: + - clients request only the data they need, improving efficiency; + - new fields and features can be added without impacting existing clients; and + - field-level usage can be tracked and monitored for insights and optimization. + +The [GraphQL 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/) +- [GraphQL Website](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/) +- [Community Resources](https://graphql.org/community/) ## Deployment -The site is deployed via Vercel on merges to the `source` branch. +The website is deployed via [Vercel](https://vercel.com) on merges to the `source` branch. To preview changes locally, follow these steps: + +1. Clone the repository: + `git clone https://github.com/graphql/graphql.github.io.git` + `cd graphql.github.io` +2. Install dependencies: + `npm install` +3. Run the site locally: + `npm run dev` + +## How to Contribute + +We welcome contributions! 🎉 Please refer to our [contributing guide](./CONTRIBUTING.md) for detailed instructions on how to make changes to the GraphQL website. + +### CLA Process -## How to contribute +Before contributing, all participants must sign the free [GraphQL Specification Membership Agreement](https://preview-spec-membership.graphql.org). You only need to do this once, and it can be signed by: -Check out our [contributing guide](./CONTRIBUTING.md) for detailed instructions on how to make changes to the GraphQL website 🎉. +- [Individual contributors](http://individual-spec-membership.graphql.org/) +- [Employers](http://corporate-spec-membership.graphql.org/) -This repository is managed by EasyCLA. Project participants must sign the free [GraphQL Specification Membership agreement](https://preview-spec-membership.graphql.org) before making a contribution. You only need to do this one time, and it can be signed by [individual contributors](http://individual-spec-membership.graphql.org/) or their [employers](http://corporate-spec-membership.graphql.org/). +To initiate the signature process, please open a PR against this repository. The EasyCLA bot will block the merge if the membership agreement has not been signed. -To initiate the signature process please open a PR against this repo. The EasyCLA bot will block the merge if we still need a membership agreement from you. +For more information on the CLA, check out the [detailed instructions here](https://github.com/graphql/graphql-wg/tree/main/membership). If you encounter any issues, please contact us at [operations@graphql.org](mailto:operations@graphql.org). -You can find [detailed information here](https://github.com/graphql/graphql-wg/tree/main/membership). If you have issues, please email operations@graphql.org. +## Join the Foundation! -If your company benefits from GraphQL and you would like to provide essential financial support for the systems and people that power our community, please also consider membership in the [GraphQL Foundation](https://foundation.graphql.org/join). +If your company benefits from GraphQL and you would like to provide essential financial support for the systems and people that power our community, please consider becoming a member of the [GraphQL Foundation](https://foundation.graphql.org/join).