Skip to content

Commit 01686c6

Browse files
authored
docs: add contribution file (#8)
* docs: add contribution md * docs: improve format * docs: remove unused file * docs: change link
1 parent 8510d59 commit 01686c6

File tree

4 files changed

+86
-47
lines changed

4 files changed

+86
-47
lines changed

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 0 additions & 3 deletions
This file was deleted.

CONTRIBUTING.md

Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
# Contributing
2+
3+
We welcome contribution from everyone.
4+
5+
## Issues
6+
7+
You can contribute to this repository
8+
9+
- Improving our [docs](https://mugglim.github.io/build-your-own-tanstack-query/).
10+
- Improving our [tanstack-query-lite](https://github.com/mugglim/build-your-own-tanstack-query/tree/chore/add-contributing/tanstack-query-lite) features.
11+
12+
## Get started
13+
14+
### Installation
15+
16+
Please follow these steps to get started:
17+
18+
- Fork and clone this repository
19+
20+
```
21+
cd build-your-own-tanstack-query
22+
```
23+
24+
- Install package
25+
```
26+
npm install
27+
```
28+
29+
### Run docs dev server
30+
31+
```
32+
npm run docs:dev
33+
```
34+
35+
### Run dev server
36+
37+
```
38+
npm run dev
39+
```
40+
41+
## Pull Requests
42+
43+
We merge pull requests by squashing all commits.
44+
Please ensure your PR template titles match the example below.
45+
46+
```
47+
<type>: <description>
48+
```
49+
50+
`type` must be one of the following:
51+
52+
- `feat`: A new tanstack-query-lite feature.
53+
- `docs`: Documentation only changes.
54+
- `fix`: A bug fix
55+
- `chore`: Anything else

README.md

Lines changed: 9 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -1,29 +1,18 @@
1-
<div align="center">
2-
<h1> Build Your Own TanStack Query and useQuery</h1>
3-
</div>
1+
# Build Your Own TanStack Query
42

5-
<p align="center">
6-
<a href="https://mugglim.github.io/build-your-own-tanstack-query">한국어</a> | <a href="/en.md">English</a>
7-
</p>
3+
<a href="https://mugglim.github.io/build-your-own-tanstack-query">한국어</a> | <a href="/en.md">English</a>
84

95
## Introduction
106

11-
We're going to rewrite TanStack Query and useQuery from scratch. We'll be using the ideas and code from [Let's Build React Query in 150 Lines of Code!](https://www.youtube.com/watch?v=9SrIirrnwk0) and TanStack Query v5.
7+
We're going to rewrite TanStack Query and useQuery from scratch.
8+
We'll be using the ideas and code from [Let's Build React Query in 150 Lines of Code!](https://www.youtube.com/watch?v=9SrIirrnwk0) and TanStack Query v5.
129

13-
## Play Locally
14-
15-
Install package
16-
17-
```
18-
npm install
19-
```
10+
## Demo
2011

21-
Run development server
12+
https://github.com/user-attachments/assets/11454b80-034a-4205-b051-5a3c78f1b9d0
2213

23-
```
24-
npm run dev
25-
```
14+
## Contributing
2615

27-
## Demo
16+
We welcome contribution from everyone. Read below for contributing guidelines.
2817

29-
https://github.com/user-attachments/assets/11454b80-034a-4205-b051-5a3c78f1b9d0
18+
[CONTRIBUTING](/CONTRIBUTING.md)

en.md

Lines changed: 22 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,11 @@
1-
<div align="center">
2-
<h1> Build Your Own TanStack Query and useQuery</h1>
3-
</div>
1+
# Build Your Own TanStack Query and useQuery
42

5-
<p align="center">
6-
<a href="./docs/ko.md">한국어</a> | <a href="/README.md">English</a>
7-
</p>
3+
<a href="./docs/ko.md">한국어</a> | <a href="/README.md">English</a>
84

95
## Introduction
106

11-
We're going to rewrite TanStack Query and useQuery from scratch. We'll be using the ideas and code from [Let's Build React Query in 150 Lines of Code!](https://www.youtube.com/watch?v=9SrIirrnwk0) and TanStack Query v5.
7+
We're going to rewrite TanStack Query and useQuery from scratch.
8+
We'll be using the ideas and code from [Let's Build React Query in 150 Lines of Code!](https://www.youtube.com/watch?v=9SrIirrnwk0) and TanStack Query v5.
129

1310
> [!WARNING]
1411
>
@@ -21,23 +18,24 @@ We're going to rewrite TanStack Query and useQuery from scratch. We'll be using
2118
2219
## TOC
2320

24-
- [Introduction](#introduction)
25-
- [TOC](#toc)
26-
- [Play Locally](#play-locally)
27-
- [Architecture](#architecture)
28-
- [Step 1: Core Implementation](#step-1-core-implementation)
29-
- [QueryClient](#queryclient)
30-
- [QueryCache](#querycache)
31-
- [Query](#query)
32-
- [QueryObserver](#queryobserver)
33-
- [Step 2: Integration with React](#step-2-integration-with-react)
34-
- [Trigger re-render when the state of Query changes](#trigger-re-render-when-the-state-of-query-changes)
35-
- [QueryClientProvider](#queryclientprovider)
36-
- [useQuery](#usequery)
37-
- [Step 3: Additional Features](#step-3-additional-features)
38-
- [1. Trigger refetch when the browser’s focus state changes](#1-trigger-refetch-when-the-browsers-focus-state-changes)
39-
- [2. Creating a developer tool like ReactQueryDevtools](#2-creating-a-developer-tool-like-reactquerydevtools)
40-
- [Reference](#reference)
21+
- [Build Your Own TanStack Query and useQuery](#build-your-own-tanstack-query-and-usequery)
22+
- [Introduction](#introduction)
23+
- [TOC](#toc)
24+
- [Play Locally](#play-locally)
25+
- [Architecture](#architecture)
26+
- [Step 1: Core Implementation](#step-1-core-implementation)
27+
- [QueryClient](#queryclient)
28+
- [QueryCache](#querycache)
29+
- [Query](#query)
30+
- [QueryObserver](#queryobserver)
31+
- [Step 2: Integration with React](#step-2-integration-with-react)
32+
- [Trigger re-render when the state of Query changes](#trigger-re-render-when-the-state-of-query-changes)
33+
- [QueryClientProvider](#queryclientprovider)
34+
- [useQuery](#usequery)
35+
- [Step 3: Additional Features](#step-3-additional-features)
36+
- [1. Trigger refetch when the browser’s focus state changes](#1-trigger-refetch-when-the-browsers-focus-state-changes)
37+
- [2. Creating a developer tool like ReactQueryDevtools](#2-creating-a-developer-tool-like-reactquerydevtools)
38+
- [Reference](#reference)
4139

4240
## Play Locally
4341

0 commit comments

Comments
 (0)