Add guidlines

This commit is contained in:
Iwasaki Yudai 2017-08-12 12:32:25 +09:00
parent e81f4e9b7e
commit 21899e638b
2 changed files with 71 additions and 0 deletions

27
.github/ISSUE_TEMPLATE.md vendored Normal file
View File

@ -0,0 +1,27 @@
# When file a bug report (see below for feature requests)
Please answer these quesions for a bug report. Thanks!
### What version of GoTTY are you using (`gotty --version`)?
### What operating system are you using?
### What did you do?
If possible, please provide the command you ran.
### What did you expect to see?
### What did you see instead?
If possible, please provide the output of the command and your browser's console output.
# When file a new feature proposal
Please provide an actual usecase that requires your new feature.

44
CONTRIBUTING.md Normal file
View File

@ -0,0 +1,44 @@
# How to contribute
GoTTY is MIT licensed and accepts contributions via GitHub pull requests. We also accepts feature requests on GitHub issues.
## Reporting a bug
Reporting a bug is always welcome and one the best ways to contribute. A good bug report helps the developers to improve the product much easier. We therefore would like to ask you to fill out the quesions on the issue template as much as possible. That helps us to figure out what's happening and discover the root cause.
## Requesting a new feature
When you find that GoTTY cannot fullfill your requirements because of lack of ability, you may want to open a new feature request. In that case, please file a new issue with your usecase and requirements.
## Opening a pull request
### Code Style
Please run `go fmt` on your Go code and make sure that your commits are organized for each logical change and your commit messages are in proper format (see below).
[Go's official code style guide](https://github.com/golang/go/wiki/CodeReviewComments) is also helpful.
### Format of the commit message
When you write a commit message, we recommend include following information to make review easier and keep the history cleaerer.
* What is the change
* The reason for the change
The following is an example:
```
Add something new to existing package
Since the existing function lacks that mechanism for some purpose,
this commit adds a new structure to provide it.
```
When your pull request is to add a new feature, we recommend add an actual usecase so that we can discuss the best way to achive your requirement. Opening a proposal issue in advance is another good way to start discussion of new features.
## Contact
If you have a trivial question about GoTTY for a bug or new feature, you can contact @i_yudai on Twitter (unfortunately, I cannot provide support on GoTTY though).