Skip to content

Latest commit

 

History

History
48 lines (41 loc) · 2.85 KB

CONTRIBUTING.md

File metadata and controls

48 lines (41 loc) · 2.85 KB

How to contribute

Important

These steps are more particular to this repo but mainly apply to all repositories; change the specifics.

Unless you explicitly state otherwise, any Contribution intentionally submitted for inclusion in this project by you, as defined in the Apache License shall be dual-licensed as above, without any additional terms or conditions.

  1. Join slack and join #dev-beginners channel
  2. Ask the owner of the repository to add your GitHub username to the repository so that you can work on issues and be able to create your own branches and not need to fork the repo

Devs & QA automation (which steps apply)

  1. Become familiar with docs and code by reading the ramp-up guide
  2. Pick an open issue or a task in the corresponding project for the repo you'll work on. You can see good for first issues that you can pick from
  3. Assign the issues you are working on to you and move them to the corresponding status column as you progress . If the task is not an issue yet, convert it to an issue first
  4. Make the changes in your branch
  5. Add docs as they apply
  6. Add tests, benchmarks, and examples for your changes, if applicable
  7. cargo fmt --all to format the code. You can configure your IDE to do this on save, RustRover and VSCode
  8. cargo clippy --all --release and fix any errors
  9. DON'T INCREASE THE VERSION NUMBER IN Cargo.toml, WE WILL DO THAT WHEN RELEASING
  10. Create a git push hook file in .git/hooks/pre-push with pre-push content on Linux and macOS, and pre-push on Windows. Make it executable in Linux and macOS with chmod +x .git/hooks/pre-push .This will run when you do git push and will make the push quite slow, but please give it time to complete as this helps to fix any issues locally and not rely just on running ci on GitHub when you create the PR
  11. Commit and push your changes, and if there are any errors, fix them before you push them
  12. Create a PR back to the parent repo targeting the main branch and request review from owners of the repository by adding them to the Reviewers field
  13. In the project, move the item to In Code Review
  14. Monitor the checks (GitHub actions runs) and fix the code if they are failing
  15. Respond to any comments
  16. DON'T MERGE THE PR YOURSELF. LEAVE THAT TO REPOSITORY OWNERS
  17. In the end, ideally, it will be merged into main

QA manual

Please follow these steps.