Skip to content

Latest commit

 

History

History
99 lines (65 loc) · 3.94 KB

CONTRIBUTING.md

File metadata and controls

99 lines (65 loc) · 3.94 KB

Contributing to Storj

Hi! Thanks for your interest in contributing to the Storj Network!

Contributions to this project are released under the AGPLv3 License. For code released under the AGPLv3, we request that contributors sign our Contributor License Agreement (CLA) so that we can re-license parts of the code under a less restrictive license, like Apache v2, if that would help the adoption of Storj in the future.

Topics

Reporting security issues

If you believe you've found a security vulnerability, please send your report to [email protected].

We greatly value security, and we may publicly thank you for your report, although we keep your name confidential if you request it.

Issue tracking and roadmap

See the breakdown of what we're building by checking out the following resources:

Quick contribution tips and guidelines

Pull requests are always welcome

To encourage active collaboration, pull requests are strongly encouraged, not just bug reports.

We accept pull requests for bug fixes and features where we've discussed the approach in an issue and given the go-ahead for a community member to work on it.

"Bug reports" may also be sent in the form of a pull request containing a failing test. We'd also love to hear about ideas for new features as issues.

Please do:

  • Check existing issues to verify that the bug or feature request has not already been submitted.
  • Open an issue if things aren't working as expected.
  • Open an issue to propose a significant change.
  • open an issue to propose a feature
  • Open a pull request to fix a bug.
  • Open a pull request for an issue with the Help Wanted or Good first issue label and leave a comment claiming it.

Please avoid:

  • Opening pull requests for issues marked Need Design, Need Investigation, Waiting For Feedback or Blocked.
  • opening pull requests that are not related to any open issue unless they are bug reports in the form pull requests containing failing tests.

Please note that this project adheres to a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Starting development

See the Developing Guide on how to start a local development, run tests or a local Storj network.

Make changes and test

Make the changes you want to see! Once you're done, you can run all the unit tests:

go test -v ./...

You can also execute only a single test package if you like. For example: go test ./pkg/identity. Add -v for more information about the executed unit tests.

See our guide for writing tests.

Commit Messages

Our guide on good commits can be found at https://github.com/storj/storj/wiki/Git.

Push up a pull request

Use Git to push your changes to your fork:

git commit -a -m 'my changes!'
git push origin main

Use GitHub to open a pull request!

Resources