Skip to content

Commit 90f5b05

Browse files
author
shuangxu
committed
feat(ko): add cn readme and Contributing
1 parent a6fa820 commit 90f5b05

File tree

6 files changed

+147
-18
lines changed

6 files changed

+147
-18
lines changed

CONTRIBUTING.md

+1-6
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,3 @@
1-
---
2-
sidebar_position: 6
3-
title: Contributing
4-
---
5-
61
# Contributing to ko
72

83
We use **pnpm workspace** to manage our packages. so make sure you use **pnpm** as package manager than **npm** or **yarn**.
@@ -15,7 +10,7 @@ pnpm install
1510

1611
## Code Structure
1712

18-
as a **monorepo**, ko now maintain 4 packages in packages directory:
13+
as a **monorepo**, ko now maintain 5 packages in packages directory:
1914

2015
* **ko**: main package
2116
* **ko-lints**: code format cli, include **eslint**, **prettier** and **stylelint**, can be integrated in ko or use individually

CONTRIBUTING_CN.md

+57
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,57 @@
1+
# 贡献到 ko
2+
3+
We use **pnpm workspace** to manage our packages. so make sure you use **pnpm** as package manager than **npm** or **yarn**.
4+
我们使用 **pnpm workspace** 来管理我们的包,请确保您使用 **pnpm** 作为包管理器,而不是 **npm****yarn**
5+
6+
在使用此仓库之前:
7+
``` bash
8+
pnpm install
9+
```
10+
11+
## 代码结构
12+
13+
作为一个 monorepo,ko 现在在 packages 目录中维护了 5 个包:
14+
15+
* **ko**: 主要包
16+
* **ko-lints**: 代码格式化 cli, 包 **eslint**, **prettier****stylelint**, 可以集成到 ko 中或单独使用
17+
* **ko-config**: **ko-lints** 使用的默认配置
18+
* **ko-lint-config**: 代码格式化配置,包括 **eslint**, **prettier****stylelint**
19+
* **babel-preset-ko-app**: ko 使用的 babel 预设
20+
21+
### 调试
22+
23+
使用 `pnpm debug` 调试本地包
24+
25+
### 本地测试
26+
27+
使用 **pnpm link**`ko` 链接到本地包中进行测试
28+
29+
## 提交 Pull Request (PR)
30+
31+
在提交 Pull Request (PR) 之前,请考虑以下准则:
32+
- 在存储库的根目录中运行 `pnpm changeset`,并描述您的更改。生成的文件应该被提交,因为它们将在发布时使用。
33+
- 运行完整的测试套件,并确保所有测试都通过。
34+
- 推送您的分支到 GitHub:
35+
36+
```shell
37+
git push origin my-fix-branch
38+
```
39+
40+
- 在 GitHub 上发送一个 pull request。
41+
- 如果我们建议更改,则:
42+
43+
- Make the required updates.
44+
- Re-run the test suites to ensure tests are still passing.
45+
- Rebase your branch and force push to your GitHub repository (this will update your Pull Request):
46+
- 进行所需的更新。
47+
48+
- 重新运行测试套件,以确保测试仍然通过。
49+
50+
- 将您的分支 rebase 并强制推送到您的 GitHub 存储库(这将更新您的 Pull Request):
51+
52+
```shell
53+
git rebase main -i
54+
git push -f
55+
```
56+
57+
感谢您的贡献!

README.md

+8-7
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,14 @@
11
# ko
2+
English | [简体中文](./README_CN.md)
23

3-
## Simple, yet powerful, tool for managing your react applications.
4+
## Simple, yet powerful, tool for managing your react applications.
45

56
<a href="https://www.npmjs.com/package/ko"><img alt="NPM Status" src="https://img.shields.io/npm/v/ko.svg?style=flat"></a>
67

78
## Features
89

910
* Support building applications on top of **webpack v5** and **esbuild**
10-
* Customize ko to work exactly the way you need it for your applications
11+
* Customize ko to work exactly the way you need it for your applications
1112
* Built-in popular linting tools to lint your source code
1213
* Built-in support typescript
1314

@@ -18,18 +19,18 @@ You can install ko using npm, yarn or pnpm:
1819
npm install ko --save-dev
1920
# or
2021
yarn add ko --dev
21-
# or
22+
# or
2223
pnpm add ko --save-dev
2324
```
2425

2526
## Documents
26-
* [Introduction](https://dtstack.github.io/ko/docs/current/introduction)
27-
* [Getting Started](https://dtstack.github.io/ko/docs/current/getting-started)
28-
* [FAQ](https://dtstack.github.io/ko/docs/current/FAQ)
27+
* [Introduction](https://dtstack.github.io/ko/zh-CN/docs/current/introduction)
28+
* [Getting Started](https://dtstack.github.io/ko/zh-CN/docs/current/getting-started)
29+
* [FAQ](https://dtstack.github.io/ko/zh-CN/docs/current/FAQ)
2930

3031
## Contributing
3132

32-
We'd love to have your helping hand on `ko`! See [CONTRIBUTING](https://github.com/DTStack/ko/blob/master/CONTRIBUTING.md) for more information on how to get started.
33+
We'd love to have your helping hand on `ko`! See [CONTRIBUTING](./CONTRIBUTING.md) for more information on how to get started.
3334

3435
## License
3536

README_CN.md

+38
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# ko
2+
3+
## 一个简单而强大的工具,用于管理您的 React 应用程序。
4+
5+
<a href="https://www.npmjs.com/package/ko"><img alt="NPM Status" src="https://img.shields.io/npm/v/ko.svg?style=flat"></a>
6+
7+
## 特点
8+
9+
* 支持在 **webpack v5****esbuild** 上构建应用程序
10+
* 定制 ko,使其完全按照您的应用程序需求工作
11+
* 内置流行的 lint 工具,用于对源代码进行 lint
12+
* 内置支持 TypeScript
13+
14+
## 安装
15+
16+
您可以使用 npm、yarn 或 pnpm 安装 ko:
17+
``` bash
18+
npm install ko --save-dev
19+
# 或者
20+
yarn add ko --dev
21+
# 或者
22+
pnpm add ko --save-dev
23+
```
24+
25+
## 文档
26+
* [介绍](https://dtstack.github.io/ko/docs/current/introduction)
27+
* [入门指南](https://dtstack.github.io/ko/docs/current/getting-started)
28+
* [常见问题](https://dtstack.github.io/ko/docs/current/FAQ)
29+
30+
## Contributing
31+
32+
我们很乐意在 `ko` 上得到您的帮助!有关如何入手的更多信息,请参见 [CONTRIBUTING](./CONTRIBUTING_CN.md)
33+
34+
## License
35+
36+
版权所有 © DTStack。保留所有权利。
37+
38+
根据 MIT 许可证获得许可。

packages/ko/README.md

+5-5
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
# ko
2-
2+
English | [简体中文](./README_CN.md)
33
## Simple, yet powerful, tool for managing your react applications.
44

55
<a href="https://www.npmjs.com/package/ko"><img alt="NPM Status" src="https://img.shields.io/npm/v/ko.svg?style=flat"></a>
@@ -23,13 +23,13 @@ pnpm add ko --save-dev
2323
```
2424

2525
## Documents
26-
* [Introduction](https://dtstack.github.io/ko/docs/introduction)
27-
* [Getting Started](https://dtstack.github.io/ko/docs/getting-started)
28-
* [FAQ](https://dtstack.github.io/ko/docs/FAQ)
26+
* [Introduction](https://dtstack.github.io/ko/zh-CN/docs/current/introduction)
27+
* [Getting Started](https://dtstack.github.io/ko/zh-CN/docs/current/getting-started)
28+
* [FAQ](https://dtstack.github.io/ko/zh-CN/docs/current/FAQ)
2929

3030
## Contributing
3131

32-
We'd love to have your helping hand on `ko`! See [CONTRIBUTING](https://dtstack.github.io/ko/docs/contributing/) for more information on how to get started.
32+
We'd love to have your helping hand on `ko`! See [CONTRIBUTING](../../CONTRIBUTING.md) for more information on how to get started.
3333

3434
## License
3535

packages/ko/README_CN.md

+38
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# ko
2+
3+
## 一个简单而强大的工具,用于管理您的 React 应用程序。
4+
5+
<a href="https://www.npmjs.com/package/ko"><img alt="NPM Status" src="https://img.shields.io/npm/v/ko.svg?style=flat"></a>
6+
7+
## 特点
8+
9+
* 支持在 **webpack v5****esbuild** 上构建应用程序
10+
* 定制 ko,使其完全按照您的应用程序需求工作
11+
* 内置流行的 lint 工具,用于对源代码进行 lint
12+
* 内置支持 TypeScript
13+
14+
## 安装
15+
16+
您可以使用 npm、yarn 或 pnpm 安装 ko:
17+
``` bash
18+
npm install ko --save-dev
19+
# 或者
20+
yarn add ko --dev
21+
# 或者
22+
pnpm add ko --save-dev
23+
```
24+
25+
## 文档
26+
* [介绍](https://dtstack.github.io/ko/docs/current/introduction)
27+
* [入门指南](https://dtstack.github.io/ko/docs/current/getting-started)
28+
* [常见问题](https://dtstack.github.io/ko/docs/current/FAQ)
29+
30+
## Contributing
31+
32+
我们很乐意在 `ko` 上得到您的帮助!有关如何入手的更多信息,请参见 [CONTRIBUTING](../../CONTRIBUTING_CN.md)
33+
34+
## License
35+
36+
版权所有 © DTStack。保留所有权利。
37+
38+
根据 MIT 许可证获得许可。

0 commit comments

Comments
 (0)