CONTRIBUTING.md 3.0 KB
Newer Older
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
1 2 3 4
# Guidelines for Contributing

Thank you for your time on Wechaty.

5
## How to [contribute](https://github.com/wechaty/wechaty/blob/master/CONTRIBUTING.md)
6 7 8

* Write a blog about Wechaty
* Create a tutorial for Wechaty
9 10 11 12
* Help expand the [wiki](https://github.com/wechaty/wechaty/wiki)
* Answer questions on the [issue](https://github.com/wechaty/wechaty/issues)
* Review [pull requests](https://github.com/wechaty/wechaty/pulls)
* Start [hacking on Wechaty](https://github.com/wechaty/wechaty/blob/master/CONTRIBUTING.md)
13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45

### Why contribute

As an open source product, Chatie thrives from contributions of community members. Whatever your skill set is, there is a lot you can do to help us make Chatie better! 
So start forking!

### Not sure where to start?

It's a myth that writing code is the only way to contribute to open source. Chatie community is open to new ideas and there are so many different ways to make valuable contributions. We have some ideas of how you can get started!

#### 1. Contribute Code

- Check out GitHub issues with the tags `good first issue`, `pull request welcome` or `help wanted`
- Write code examples for documentation
- Report a bug and work on resolving it
- Collaborate with others on building new features

**Tips:** 
If you want to add new features or change the API, please submit an issue first to make sure no one else is already working on the same thing and discuss the implementation and API details with maintainers and users by creating an issue. When everything is settled down, you can submit a pull request.

Make sure to add tests for your features and bugfixes and update the documentation (see below) before submitting your code!

#### 2. Contribute Support

- Fix typos in documentation
- Translate documentation to your local language
- Write tutorials and blog posts, see more: https://github.com/chatie/blog
- Answer questions on the Wechaty Developers Home or Github issues
- Organize Chatie meetups or user groups in your area

Contact rui@chatie.io to learn more

## Link to Wechaty
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
46 47 48

Contribute by marketing: Add **Powered by Wechaty** Badge to your Project Homepage:

49
[![Powered by Wechaty](https://img.shields.io/badge/Powered%20By-Wechaty-green.svg)](https://github.com/wechaty/wechaty)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
50

51
### Markdown
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
52 53

```markdown
54
[![Powered by Wechaty](https://img.shields.io/badge/Powered%20By-Wechaty-green.svg)](https://github.com/wechaty/wechaty)
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
55 56
```

57
### Html
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
58 59

```html
60
<a href="https://github.com/wechaty/wechaty" target="_blank">
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
61 62 63 64
  <img src="https://img.shields.io/badge/Powered%20By-Wechaty-green.svg" alt="Powered by Wechaty" border="0">
</a>
```

65
## Bug Report
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
66 67 68

Contribute by feedback, make code robust.

69
## Feature Request
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
70 71 72

Contribute by make product suggestion.

73
## Pull Request
Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
74 75 76 77

Please:
 
1. submit issue to describe the problem to get start
Huan (李卓桓)'s avatar
doc  
Huan (李卓桓) 已提交
78 79 80 81 82 83 84
1. then send pull request as you need(with unit test & pass linting)
 
  ```bash
  $ npm run lint
  $ npm run test
  ```

Huan (李卓桓)'s avatar
Huan (李卓桓) 已提交
85 86 87 88 89 90 91
1. and do not forget to reference the issue 

I built wechaty with pleasure because it can help others. help from you for wechaty will be very appreciated by the community.

Cheers!

Huan