Skip to content

Latest commit

 

History

History
42 lines (30 loc) · 3.17 KB

contributing.md

File metadata and controls

42 lines (30 loc) · 3.17 KB
Raw

How to Contribute to Bifrost

Bifrost is an open bridge, it is a project that is open to contributions from the community. If you would like to contribute to Bifrost, please follow the guidelines below.

Code of Conduct

Bifrost has adopted a Code of Conduct that we expect project participants to adhere to. Please read the full text so that you can understand what actions will and will not be tolerated.

Reporting Issues

If you have found a bug or have a feature request, please report them at this repository's issues section. Please check that your issue has not already been reported.

Contributing Code

If you would like to contribute code to fix a bug, implement a new feature, or improve the documentation, please follow the steps below:

  1. Open a detailed issue for your contribution (here)[https://github.com/opensaucerer/bifrost/issues] but you should only do that if one doesn't already exist.
  2. Fork the repository.
  3. Create a new branch for your fix/feature.
  4. Make your changes, committing at logical breaks.
  5. Note importantly that your commit messages should be descriptive and follow the semantic commit message format.
  6. Make sure you have added the necessary tests for your changes.
  7. Run all the tests to assure nothing else was accidentally broken.
  8. Update the changelog.md file with a description of your changes/addition. The order of representation is that whereby your most recent changes/addition come first.
  9. Push your branch to your fork of the repository.
  10. Submit a pull request to the main branch of the Bifrost repository.
  11. Remember to link your pull request with the issue you created for it.
  12. Ensure that your pull request is descriptive and passes all status checks.
  13. Pat yourself on the back and wait for your pull request to be reviewed and merged.

Becoming a Collaborator (Maintainer)

To become a collborator on Bifrost means getting added to the list of those with direct access to the repository. This means you can, sometimes (not at all times), make direct push to the repistory without having to go through the pull request route. But since this grants delicate access, it is important that you meet some certain criterias. These include but might be limited to...

  • proven experience in the field of software engineering
  • proven experience working with the language this package is written in
  • proven track of following the laid down rules of this project
  • a good track record of contribution, adaptation, and communication on this project
  • and, of course, a good record of dedication to the project's cause.

Note however that we can't have to many collaborators, which means you might meet this criterias but still not get the role. Likewise, it is possible that you be relieve of your collaborator role if the team notices consistent unavailability. We understand that open source can be tasking and we won't aim to pressure you much more than you can handle but would still love the project to go on by allowing others the chance of sustainable development.