mirror of
https://github.com/spf13/cobra
synced 2024-11-14 09:47:16 +00:00
51 lines
2 KiB
Markdown
51 lines
2 KiB
Markdown
|
# Contributing to Cobra
|
||
|
|
|
||
|
|
Thank you so much for contributing to Cobra. We appreciate your time and help.
|
||
|
|
Here are some guidelines to help you get started.
|
||
|
|
|
||
|
|
## Code of Conduct
|
||
|
|
|
||
|
|
Be kind and respectful to the members of the community. Take time to educate
|
||
|
|
others who are seeking help. Harassment of any kind will not be tolerated.
|
||
|
|
|
||
|
|
## Questions
|
||
|
|
|
||
|
|
If you have questions regarding Cobra, feel free to ask it in the community
|
||
|
|
[#cobra Slack channel][cobra-slack]
|
||
|
|
|
||
|
|
## Filing a bug or feature
|
||
|
|
|
||
|
|
1. Before filing an issue, please check the existing issues to see if a
|
||
|
|
similar one was already opened. If there is one already opened, feel free
|
||
|
|
to comment on it.
|
||
|
|
1. If you believe you've found a bug, please provide detailed steps of
|
||
|
|
reproduction, the version of Cobra and anything else you believe will be
|
||
|
|
useful to help troubleshoot it (e.g. OS environment, environment variables,
|
||
|
|
etc...). Also state the current behavior vs. the expected behavior.
|
||
|
|
1. If you'd like to see a feature or an enhancement please open an issue with
|
||
|
|
a clear title and description of what the feature is and why it would be
|
||
|
|
beneficial to the project and its users.
|
||
|
|
|
||
|
|
## Submitting changes
|
||
|
|
|
||
|
|
1. CLA: Upon submitting a Pull Request (PR), contributors will be prompted to
|
||
|
|
sign a CLA. Please sign the CLA :slightly_smiling_face:
|
||
|
|
1. Tests: If you are submitting code, please ensure you have adequate tests
|
||
|
|
for the feature. Tests can be run via `go test ./...` or `make test`.
|
||
|
|
1. Since this is golang project, ensure the new code is properly formatted to
|
||
|
|
ensure code consistency. Run `make all`.
|
||
|
|
|
||
|
|
### Quick steps to contribute
|
||
|
|
|
||
|
|
1. Fork the project.
|
||
|
|
1. Download your fork to your PC (`git clone https://github.com/your_username/cobra && cd cobra`)
|
||
|
|
1. Create your feature branch (`git checkout -b my-new-feature`)
|
||
|
|
1. Make changes and run tests (`make test`)
|
||
|
|
1. Add them to staging (`git add .`)
|
||
|
|
1. Commit your changes (`git commit -m 'Add some feature'`)
|
||
|
|
1. Push to the branch (`git push origin my-new-feature`)
|
||
|
|
1. Create new pull request
|
||
|
|
|
||
|
|
<!-- Links -->
|
||
|
|
[cobra-slack]: https://gophers.slack.com/archives/CD3LP1199
|