go-sylixos/elvish
3
0
Fork 0
mirror of https://github.com/go-sylixos/elvish.git synced 2024-12-16 04:48:27 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity
acb157d929
elvish/CONTRIBUTING.md
Qi Xiao 0aedd830a9 Improve contributing doc.
2018-01-01 14:58:28 +00:00

1.4 KiB
Raw Blame History

Notes for Contributors

Code

  1. Always run unit tests before committing. make will take care of this.

  2. Some files are generated from other files. They should be committed into the repository for this package to be go-gettable. Run go generate ./... to regenerate them in case you modified the source.

    We use the stringer tool in some generation rules. Install with go get -u golang.org/x/tools/cmd/stringer.

  3. Always format the code with goimports before committing. Run go get golang.org/x/tools/cmd/goimports to install goimports, and goimports -w . to format all golang sources.

    To automate this you can set up a goimports filter for Git by putting this in ~/.gitconfig:

    [filter "goimports"]
    clean = goimports
    smudge = cat

    Git will then always run goimports for you before committing, since .gitattributes in this repository refers to this filter. More about Git attributes and filters here.

Human Communication

If you are making significant changes or any user-visible changes (e.g. changes to the language, the UI or the elv script API), please discuss on the developer channel before starting to work.

Licensing

By contributing, you agree to license your code under the same license as existing source code of elvish. See the LICENSE file.