2017-10-06 15:29:20 +00:00
|
|
|
# Contributing
|
|
|
|
|
|
|
|
|
|
Of course, contributions are more than welcome. Please read these guidelines for
|
|
|
|
|
making the process as painless as possible.
|
|
|
|
|
|
|
|
|
|
## Discussion
|
|
|
|
|
|
|
|
|
|
Development discussion should take place on the #mage channel of [gopher
|
|
|
|
|
slack](https://gophers.slack.com/).
|
|
|
|
|
|
|
|
|
|
There is a separate #mage-dev channel that has the github app to post github
|
|
|
|
|
activity to the channel, to make it easy to follow.
|
|
|
|
|
|
|
|
|
|
## Issues
|
|
|
|
|
|
|
|
|
|
If there's an issue you'd like to work on, please comment on it, so we can
|
|
|
|
|
discuss approach, etc. and make sure no one else is currently working on that
|
|
|
|
|
issue.
|
|
|
|
|
|
|
|
|
|
Please always create an issue before sending a PR unless it's an obvious typo
|
|
|
|
|
or other trivial change.
|
|
|
|
|
|
|
|
|
|
## Dependency Management
|
|
|
|
|
|
2018-01-03 19:29:07 +00:00
|
|
|
Currently mage has no dependencies(!). Let's try to keep it that way. Since
|
|
|
|
|
it's likely that mage will be vendored into a project, adding dependencies to
|
|
|
|
|
mage adds dependencies to every project that uses mage.
|
2017-10-06 15:29:20 +00:00
|
|
|
|
|
|
|
|
## Versions
|
|
|
|
|
|
2018-01-03 19:29:07 +00:00
|
|
|
Please try to avoid using features of go and the stdlib that prevent mage from
|
|
|
|
|
being buildable with old versions of Go. Definitely avoid anything that
|
|
|
|
|
requires go 1.9.
|
2017-10-06 15:29:20 +00:00
|
|
|
|
|
|
|
|
## Testing
|
|
|
|
|
|
|
|
|
|
Please write tests for any new features. Tests must use the normal go testing
|
|
|
|
|
package.
|
|
|
|
|
|
|
|
|
|
Tests must pass the race detector (run `go test -race ./...`).
|
|
|
|
|
|
