|
1 |
| -# Source Repository for graphql.org |
| 1 | +# Source Repository for GraphQL.org |
2 | 2 |
|
3 | 3 | This repository contains the source code for the [GraphQL website](https://graphql.org).
|
4 | 4 |
|
5 |
| -> 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/) |
| 5 | +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/). |
6 | 6 |
|
7 |
| -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/). |
| 7 | +## Table of Contents |
| 8 | + |
| 9 | +- [Overview](#overview) |
| 10 | +- [Documentation](#documentation) |
| 11 | +- [Deployment](#deployment) |
| 12 | +- [How to Contribute](#how-to-contribute) |
| 13 | +- [CLA Process](#cla-process) |
| 14 | +- [Financial Support](#financial-support) |
| 15 | + |
| 16 | +## Overview |
| 17 | + |
| 18 | +**GraphQL** is a query language for APIs and a runtime for fulfilling those queries with your existing data. It provides: |
| 19 | +- A complete and understandable description of the data in your API. |
| 20 | +- The ability for clients to ask for exactly what they need. |
| 21 | +- Powerful developer tools. |
| 22 | + |
| 23 | +The [GraphQL Specification](https://spec.graphql.org/) is open source and governed by the [GraphQL Foundation](https://foundation.graphql.org/). |
8 | 24 |
|
9 | 25 | ## Documentation
|
10 | 26 |
|
11 |
| -- [Site](https://graphql.org/) |
12 |
| -- [Reference documentation](https://graphql.org/learn/) |
13 |
| -- [Language support, tools, and services](https://graphql.org/code/) |
14 |
| -- [Frequently Asked Questions (FAQ)](https://graphql.org/faq/) |
15 |
| -- [Community resources](https://graphql.org/community/) |
| 27 | +- [GraphQL Website](https://graphql.org/) |
| 28 | +- [Reference Documentation](https://graphql.org/learn/) - Detailed guides and tutorials. |
| 29 | +- [Language Support, Tools, and Services](https://graphql.org/code/) - Available tools and libraries for different languages. |
| 30 | +- [Frequently Asked Questions (FAQ)](https://graphql.org/faq/) - Answers to common questions. |
| 31 | +- [Community Resources](https://graphql.org/community/) - Community-driven resources. |
16 | 32 |
|
17 | 33 | ## Deployment
|
18 | 34 |
|
19 |
| -The site is deployed via Vercel on merges to the `source` branch. |
| 35 | +The website is deployed via [Vercel](https://vercel.com) on merges to the `source` branch. To preview changes locally, follow these steps: |
| 36 | +1. Clone the repository: |
| 37 | + `git clone https://github.com/graphql/graphql.github.io.git` |
| 38 | +2. Install dependencies: |
| 39 | + `npm install` |
| 40 | +3. Run the site locally: |
| 41 | + `npm start` |
| 42 | + |
| 43 | +## How to Contribute |
| 44 | + |
| 45 | +We welcome contributions! 🎉 Please refer to our [contributing guide](./CONTRIBUTING.md) for detailed instructions on how to make changes to the GraphQL website. |
20 | 46 |
|
21 |
| -## How to contribute |
| 47 | +### CLA Process |
22 | 48 |
|
23 |
| -Check out our [contributing guide](./CONTRIBUTING.md) for detailed instructions on how to make changes to the GraphQL website 🎉. |
| 49 | +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: |
| 50 | +- [Individual contributors](http://individual-spec-membership.graphql.org/) |
| 51 | +- [Employers](http://corporate-spec-membership.graphql.org/) |
24 | 52 |
|
25 |
| -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/). |
| 53 | +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. |
26 | 54 |
|
27 |
| -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. |
| 55 | +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). |
28 | 56 |
|
29 |
| -You can find [detailed information here](https://github.com/graphql/graphql-wg/tree/main/membership). If you have issues, please email operations@graphql.org. |
| 57 | +## Financial Support |
30 | 58 |
|
31 |
| -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). |
| 59 | +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). |
0 commit comments