mirror of https://github.com/tidwall/tile38.git
50 lines
1.3 KiB
Markdown
50 lines
1.3 KiB
Markdown
|
# How to Contribute
|
||
|
Any kind of contributions are welcome.
|
||
|
|
||
|
## Building GopherLua
|
||
|
|
||
|
GopherLua uses simple inlining tool for generate efficient codes. This tool requires python interpreter. Files name of which starts with `_` genarate files name of which does not starts with `_` . For instance, `_state.go` generate `state.go` . You do not edit generated sources.
|
||
|
To generate sources, some make target is available.
|
||
|
|
||
|
```bash
|
||
|
make build
|
||
|
make glua
|
||
|
make test
|
||
|
```
|
||
|
|
||
|
You have to run `make build` before committing to the repository.
|
||
|
|
||
|
## Pull requests
|
||
|
Our workflow is based on the [github-flow](https://guides.github.com/introduction/flow/>) .
|
||
|
|
||
|
1. Create a new issue.
|
||
|
2. Fork the project.
|
||
|
3. Clone your fork and add the upstream.
|
||
|
```bash
|
||
|
git remote add upstream https://github.com/yuin/gopher-lua.git
|
||
|
```
|
||
|
|
||
|
4. Pull new changes from the upstream.
|
||
|
```bash
|
||
|
git checkout master
|
||
|
git fetch upstream
|
||
|
git merge upstream/master
|
||
|
```
|
||
|
|
||
|
5. Create a feature branch
|
||
|
```bash
|
||
|
git checkout -b <branch-name>
|
||
|
```
|
||
|
|
||
|
6. Commit your changes and reference the issue number in your comment.
|
||
|
```bash
|
||
|
git commit -m "Issue #<issue-ref> : <your message>"
|
||
|
```
|
||
|
|
||
|
7. Push the feature branch to your remote repository.
|
||
|
```bash
|
||
|
git push origin <branch-name>
|
||
|
```
|
||
|
|
||
|
8. Open new pull request.
|