Skip to content

Latest commit

 

History

History
67 lines (42 loc) · 3.04 KB

CONTRIBUTING.md

File metadata and controls

67 lines (42 loc) · 3.04 KB
Raw

LightStep Community Contributing Guide

First, 🎉 thanks for contributing! 🎉

Issues

You're encouraged to log issues for any questions or problems you might have. When in doubt, log an issue. The exception to this rule is security disclosures.

Generally speaking, the more context you can provide, the better. Please add information such as what version you're using, stack traces and/or logs (to the extent that you're able to share them), and whatever else you think may be relevant. Project maintainers may ask for additional clarification, logs, and other pertinent metadata before we can address your issue.

For bug submission, we especially appreciate details on how to reproduce the bug to the extent you're able to provide them, e.g., an isolated repo or gist.

Reporting Security Issues

If you find a security issue, please do not file a public issue for it. Instead, send your report to us privately at [email protected].

Contributions

All contributions big and small are welcome, from typo corrections to bug fixes to suggested improvements!

Any changes to project resources in this repository must be made through a pull request. This includes, but is not limited to, changes affecting:

  • Documentation
  • Source code
  • Binaries
  • Sample projects or other examples

No pull request can be merged without at least one review from a maintainer.

By default, contributions are accepted once no committers object to the PR. Specific contributors may be suggested or required to review a pull request based on repository settings.

In the event of objections or disagreement, everyone involved should seek to arrive at a consensus around the expressed objections. These can take the form of addressing concerns through changes, compromising around the change, or withdrawing it entirely.

Development

Testing

To run the tests:

make test

Style Guide

To check for linting errors:

make lint

Submitting a Pull Request

Note that this section should be treated as a general guideline and replaced with language/repo specific instructions

  1. Fork the repository.
  2. Create a new branch.
  3. Add tests for your change.
  4. Run the tests to make sure that they don't already pass. If they do (and you're not backfilling test coverage), please modify them.
  5. Implement the change such that your new tests pass.
  6. Make sure that your code conforms to the style guide.
  7. Commit and push your changes.
  8. Submit your pull request.
  9. Adjust your pull request based on feedback.
  10. Get it merged! 🎉

We're happy to help with any questions you may have on the git or GitHub side, e.g., how to push a branch to your fork. Just create an issue and we'll try to help answer them :)