Skip to content

Commit 689d71e

Browse files
Update README to improve clarity and add missing sections
1 parent 53f4f75 commit 689d71e

File tree

1 file changed

+43
-15
lines changed

1 file changed

+43
-15
lines changed

README.md

Lines changed: 43 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,59 @@
1-
# Source Repository for graphql.org
1+
# Source Repository for GraphQL.org
22

33
This repository contains the source code for the [GraphQL website](https://graphql.org).
44

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/).
66

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/).
824

925
## Documentation
1026

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.
1632

1733
## Deployment
1834

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.
2046

21-
## How to contribute
47+
### CLA Process
2248

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/)
2452

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.
2654

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).
2856

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
3058

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

Comments
 (0)