Skip to content
This repository was archived by the owner on Feb 13, 2024. It is now read-only.

Commit 34fde16

Browse files
committed
docs: update template
1 parent 59747f7 commit 34fde16

File tree

9 files changed

+112
-183
lines changed

9 files changed

+112
-183
lines changed

.github/CODE_OF_CONDUCT.md

Lines changed: 36 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,12 @@
22

33
## Our Pledge
44

5-
In the interest of fostering an open and welcoming environment, we as contributors and maintainers pledge to making participation in our project and our community a harassment-free experience for everyone, regardless of age, body size, disability, ethnicity, gender identity and expression, level of experience, nationality, personal appearance, race, religion, or sexual identity and orientation.
5+
In the interest of fostering an open and welcoming environment, we as
6+
contributors and maintainers pledge to making participation in our project
7+
and our community a harassment-free experience for everyone, regardless of
8+
age, body size, disability, ethnicity, gender identity and expression, level
9+
of experience, nationality, personal appearance, race, religion, or sexual
10+
identity and orientation.
611

712
## Our Standards
813

@@ -19,31 +24,52 @@ Examples of unacceptable behavior by participants include:
1924
* The use of sexualized language or imagery and unwelcome sexual attention or advances
2025
* Trolling, insulting/derogatory comments, and personal or political attacks
2126
* Public or private harassment
22-
* Publishing others' private information, such as a physical or electronic address, without explicit permission
23-
* Other conduct which could reasonably be considered inappropriate in a professional setting
27+
* Publishing others' private information, such as a physical or electronic
28+
address, without explicit permission
29+
* Other conduct which could reasonably be considered inappropriate in
30+
a professional setting
2431

2532
## Our Responsibilities
2633

27-
Project maintainers are responsible for clarifying the standards of acceptable behavior and are expected to take appropriate and fair corrective action in response to any instances of unacceptable behavior.
34+
Project maintainers are responsible for clarifying the standards of acceptable
35+
behavior and are expected to take appropriate and fair corrective action in
36+
response to any instances of unacceptable behavior.
2837

29-
Project maintainers have the right and responsibility to remove, edit, or reject comments, commits, code, wiki edits, issues, and other contributions that are not aligned to this Code of Conduct, or to ban temporarily or permanently any contributor for other behaviors that they deem inappropriate, threatening, offensive, or harmful.
38+
Project maintainers have the right and responsibility to remove, edit, or
39+
reject comments, commits, code, wiki edits, issues, and other contributions
40+
that are not aligned to this Code of Conduct, or to ban temporarily or
41+
permanently any contributor for other behaviors that they deem inappropriate,
42+
threatening, offensive, or harmful.
3043

3144
## Scope
3245

33-
This Code of Conduct applies both within project spaces and in public spaces when an individual is representing the project or its community. Examples of representing a project or community include using an official project e-mail address, posting via an official social media account, or acting as an appointed representative at an online or offline event. Representation of a project may be further defined and clarified by project maintainers.
46+
This Code of Conduct applies both within project spaces and in public spaces
47+
when an individual is representing the project or its community. Examples of
48+
representing a project or community include using an official project e-mail
49+
address, posting via an official social media account, or acting as an
50+
appointed representative at an online or offline event. Representation of a
51+
project may be further defined and clarified by project maintainers.
3452

3553
## Enforcement
3654

37-
Instances of abusive, harassing, or otherwise unacceptable behavior may be reported by contacting the project team at cneyhn@gmail.com or xiazeyu_2011@126.com. The project team will review and investigate all complaints, and will respond in a way that it deems appropriate to the circumstances. The project team is obligated to maintain confidentiality with regard to the reporter of an incident. Further details of specific enforcement policies may be posted separately.
55+
Instances of abusive, harassing, or otherwise unacceptable behavior may be
56+
reported by contacting the project team at cneyhn@gmail.com or
57+
xiazeyu_2011@126.com. The project team will review and investigate all
58+
complaints, and will respond in a way that it deems appropriate to the
59+
circumstances. The project team is obligated to maintain confidentiality
60+
with regard to the reporter of an incident. Further details of specific
61+
enforcement policies may be posted separately.
3862

39-
Project maintainers who do not follow or enforce the Code of Conduct in good faith may face temporary or permanent repercussions as determined by other members of the project's leadership.
63+
Project maintainers who do not follow or enforce the Code of Conduct in
64+
good faith may face temporary or permanent repercussions as determined
65+
by other members of the project's leadership.
4066

4167
## Attribution
4268

43-
This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
69+
This Code of Conduct is adapted from the [Contributor Covenant][homepage],
70+
version 1.4, available at [http://contributor-covenant.org/version/1/4][version]
4471

4572
The second dimension is the best!
4673

47-
4874
[homepage]: http://contributor-covenant.org
4975
[version]: http://contributor-covenant.org/version/1/4/

.github/CONTRIBUTING.md

Lines changed: 29 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -1,25 +1,27 @@
11
# Contributing
22

3-
43
## Issues
54

6-
- Most of the time, if this plugin is not working correctly for you it is a simple **configuration** issue.
7-
8-
- **Search on the internet** and **among closed issues** in advance would do a great help for us.
5+
- Most of the time, if this plugin is not working correctly for you it is
6+
a simple **configuration** issue.
97

10-
- Please **keep focus on the topic** of any issue, and use **English** as far as possible so that everyone will understand you.
8+
- **Search on the internet** and **among closed issues** in advance would
9+
do a great help for us.
1110

12-
- **If you have discovered a bug or have a feature suggestion, feel free to create an issue on Github.**
11+
- Please **keep focus on the topic** of any issue~~, and use **English** as
12+
far as possible so that everyone will understand you.~~
1313

14+
- **If you have discovered a bug or have a feature suggestion, feel free to
15+
create an issue or pull request on Github.**
1416

1517
## Contributing directly to the source code
1618

17-
**Working on your first Pull Request?** You can learn how from this *free* series
18-
[How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)
19+
**Working on your first Pull Request?** You can learn how from this *free*
20+
series
21+
[How to Contribute to an Open Source Project on GitHub](https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github)
1922

2023
See workflow for more code developing information.
2124

22-
2325
## Submitting Changes
2426

2527
After getting some feedback, push to your fork and submit a pull request. We
@@ -29,59 +31,59 @@ your pull request should be accepted quickly.
2931
Some things that will increase the chance that your pull request is accepted:
3032

3133
- Follow the existing coding style
34+
- run `npm run lint` before you commit it.(or use `npm run lint -- fix` to try to fix automaticly)
3235
- Write a good commit message use `npm run commit`
3336
- Make sure that your code can work properly.
3437

35-
3638
## Documentation
3739

38-
live2d-widget.js's feature is now becoming richer and richer, and documentation is a huge time sink.
39-
We greatly appreciate any time spent fixing typos or clarifying sections in the
40-
documentation.
40+
live2d-widget.js's feature is now becoming richer and richer, and
41+
documentation is a huge time sink.We greatly appreciate any time
42+
spent fixing typos or clarifying sections in the documentation.
4143

4244
From opening a bug report to creating a pull request: every contribution is
4345
appreciated and welcome. If you're planning to implement a new feature or change
4446
the api please create an issue first. This way we can ensure that your precious
4547
work is not in vain.
4648

47-
48-
4949
## Workflow: modify the code
5050

51-
- We use **[EditorConfig](http://editorconfig.org/)** to define and maintain consistent coding styles, so have a look first.
51+
- We use **[EditorConfig](http://editorconfig.org/)** to define and maintain
52+
consistent coding styles, so have a look first.
5253

5354
- Please use the latest version of Node.js to work with.
5455

56+
### 0. Fork at first
57+
5558
### 1. Install environments
5659

57-
- Use `npm run inst:dev` to install all the environments.
60+
- Use `npm run inst:dev` to **install all the environments**.
5861

5962
### 2. Make changes
6063

6164
- Modify files in `/src/`
6265

6366
- Use `npm run build:dev` to build client js files **with debug files and watchdog.**.
6467

65-
### 3. Debug until you make sure that your code works properly.
68+
### 3. Debug until you make sure that your code works properly
6669

6770
### 4. Commit those changes
6871

69-
- **Use `npm run build:prod` to build final client js.**
70-
**Important!!! The step must be done before commit!!!**
72+
- Use `npm run lint` to check your code first, or use `npm run lint -- fix` to try to fix automaticly.
73+
74+
- Use `npm run build` to build final client js.
7175

72-
- Use `git add .`, or choose the file you want to commit.
76+
- Use `git add --all`, or choose the file you want to commit.
7377

74-
- Use `npm run commit` to commit, **Never use `git commit`!!!**
78+
- We recommend `npm run commit` to commit, **please follow the Angular style**
7579

7680
### 5. Push the changes
7781

7882
- Use `git push` to push the changes to the github server.
7983

80-
8184
## Workflow(author): Release a new version
8285

83-
*Let the Collaborator or author do it.*
84-
86+
### Let the Collaborator or author do it
8587

8688
### 1. Bump the version
8789

@@ -97,12 +99,12 @@ work is not in vain.
9799

98100
### 3. Commit package.json and package-lock.json
99101

100-
- Use `npm run commit` to commit, **Never use `git commit`!!!**
102+
- Use `npm run commit` to commit
101103

102104
### 4. Tag and release a new version
103105

104106
- In the Github page.
105107

106-
### 5. Publish the package to npm.
108+
### 5. Publish the package to npm
107109

108110
- Use `npm publish` to publish it.

.github/ISSUE_TEMPLATE.md

Lines changed: 8 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,12 @@
1-
### Expected behavior 预期行为
1+
# Issue
22

3-
### Actual behavior 实际行为
3+
- [ ] I have alreday read instructions in [CONTRIBUTING](CONTRIBUTING.md).
4+
我已仔细阅读[CONTRIBUTING](CONTRIBUTING.md)中的相关内容。
45

5-
### Steps to reproduce the behavior 复现步骤
6+
- [ ] I have alreday read instructions in [README](../README.md).
7+
我已仔细阅读[README](../README.md)中的相关内容。
68

9+
> Change the `[ ]` into `[x]` to show my acceptance.
10+
`[ ]` 变为 `[x]` 来表示我接受了这些问题。
711

8-
- [ ] I have alreday read instructions in [CONTRIBUTING](./CONTRIBUTING.md).
9-
我已仔细阅读[CONTRIBUTING](./CONTRIBUTING.md)中的相关内容。
10-
11-
> Change the `[ ]` into `[x]` to show your acceptance.
12-
`[ ]` 变为 `[x]` 来表示你接受了这些问题。
13-
14-
15-
@EYHN @xiazeyu
12+
@xiazeyu @EYHN

.github/ISSUE_TEMPLATE/-----.md

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

.github/ISSUE_TEMPLATE/----.md

Lines changed: 0 additions & 49 deletions
This file was deleted.
Lines changed: 23 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,67 +1,49 @@
11
---
2-
name: Bug report 错误报告
3-
about: Create a report to help us improve 创造一个报告以便更好地迭代
2+
name: 错误报告
3+
about: 创造一个报告以便更好地迭代
44

55
---
66

7-
**Describe the bug**
87
**描述你的问题**
9-
A clear and concise description of what the bug is.
108
请简明清晰地描述您所遇到的问题
119

12-
**To Reproduce**
1310
**复现步骤**
14-
Steps to reproduce the behavior:
1511
复现此问题的步骤
16-
URL 出现问题的网站地址:
17-
Console output 控制台输出:
1812

19-
1. Go to '...'
20-
打开'...'
21-
2. Click on '....'
22-
双击'...'
23-
3. Scroll down to '....'
24-
滑动到'...'
25-
4. See error of '...'
26-
发现'...'错误
13+
出现问题的网站地址:
14+
加载命令:
15+
```js
16+
17+
L2Dwidget.init();
18+
19+
```
20+
控制台输出:
21+
22+
1. 打开'...'
23+
2. 双击'...'
24+
3. 滑动到'...'
25+
4. 发现'...'错误
2726

28-
**Expected behavior**
2927
**预期的行为**
30-
A clear and concise description of what you expected to happen.
3128
请简明清晰地描述此操作预期的结果
3229

33-
**Screenshots**
3430
**屏幕截图**
35-
If applicable, add screenshots to help explain your problem.
3631
如果可能, 请添加一些屏幕截图来更好地描述你的问题
3732

38-
**Environment (please complete the following information):**
3933
**环境信息(请务必填写下列信息)**
40-
- Device: [e.g. iPhone 6, PC]
41-
- OS操作系统: [e.g. iOS 8.1, Windows 10]
42-
- Browser浏览器 [e.g. Chrome 66, Safari 11.2]
43-
- live2d-widget: [e.g. 3.0.0]
44-
> use `npm ls live2d-widget` to get current plugin's version.
45-
使用 `npm ls live2d-widget` 来获取当前插件版本.
46-
- Command of loading加载命令:
47-
```js
48-
49-
L2Dwidget.init();
50-
51-
```
34+
- 设备: [e.g. iPhone 6, PC]
35+
- 操作系统: [e.g. iOS 8.1, Windows 10]
36+
- 浏览器 [e.g. Chrome 66, Safari 11.2]
37+
- live2d-widget: [e.g. 3.0.0]
38+
> 使用 `npm ls live2d-widget` 来获取当前插件版本.
5239
53-
**Additional context**
5440
**额外的信息**
55-
Add any other context about the problem here.
5641
请在此处描述其他的内容
5742

58-
- [ ] I have alreday read instructions in [CONTRIBUTING](CONTRIBUTING.md).
59-
我已仔细阅读[CONTRIBUTING](CONTRIBUTING.md)中的相关内容。
43+
- [ ] 我已仔细阅读[CONTRIBUTING](CONTRIBUTING.md)中的相关内容。
6044

61-
- [ ] I have alreday read instructions in [README](../README.md).
62-
我已仔细阅读[README](../README.md)中的相关内容。
45+
- [ ] 我已仔细阅读[README](../README.md)中的相关内容。
6346

64-
> Change the `[ ]` into `[x]` to show your acceptance.
65-
`[ ]` 变为 `[x]` 来表示你接受了这些问题。
47+
> `[ ]` 变为 `[x]` 来表示我接受了这些问题。
6648
6749
@EYHN @xiazeyu

0 commit comments

Comments
 (0)