docs: update contributing guide (#3089)

Signed-off-by: spacewander <spacewanderlzx@gmail.com>
This commit is contained in:
罗泽轩 2020-12-21 20:13:21 +08:00 committed by GitHub
parent 7c158b739a
commit 0670eff88f
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 18 additions and 0 deletions

13
.github/semantic.yml vendored
View File

@ -1,2 +1,15 @@
titleOnly: true titleOnly: true
allowRevertCommits: true allowRevertCommits: true
types:
- feat
- fix
- docs
- style
- refactor
- perf
- test
- build
- ci
- chore
- revert
- change

View File

@ -47,6 +47,7 @@ Once we've discussed your changes and you've got your code ready, make sure that
* Includes tests for new functionality. * Includes tests for new functionality.
* References the original issue in the description, e.g. "Resolves #123". * References the original issue in the description, e.g. "Resolves #123".
* Has a [good commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html). * Has a [good commit message](http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html).
* Ensure your pull request's title starts from one of the word in the `types` section of [semantic.yml](https://github.com/apache/apisix/blob/master/.github/semantic.yml).
## Contribution Guidelines for Documentation ## Contribution Guidelines for Documentation
@ -113,6 +114,8 @@ Once we've discussed your changes and you've got your code ready, make sure that
apisix/plugins/limit-count/*.lua > \ apisix/plugins/limit-count/*.lua > \
/tmp/check.log 2>&1 || (cat /tmp/check.log && exit 1) /tmp/check.log 2>&1 || (cat /tmp/check.log && exit 1)
``` ```
The `lj-releng` will be downloaded automatically by `make lint` if not exists.
* test case style * test case style
* Use tool to check your test case style statically by command, eg: `reindex t/admin/*.t`. * Use tool to check your test case style statically by command, eg: `reindex t/admin/*.t`.
```shell ```shell
@ -128,6 +131,8 @@ Once we've discussed your changes and you've got your code ready, make sure that
reindex: t/plugin/zipkin.t: skipped. reindex: t/plugin/zipkin.t: skipped.
``` ```
* By the way, we can download "reindex" to another path and add this path to "PATH" environment. * By the way, we can download "reindex" to another path and add this path to "PATH" environment.
* When the test file is too large, for example > 800 lines, you should split it to a new file.
Please take a look at `t/plugin/limit-conn.t` and `t/plugin/limit-conn2.t`.
## Do you have questions about the source code? ## Do you have questions about the source code?