Skip to content

Latest commit

 

History

History
85 lines (57 loc) · 2.05 KB

CONTRIBUTING.md

File metadata and controls

85 lines (57 loc) · 2.05 KB
Raw

Contribution guidelines

First off, thank you for considering contributing to cargo-blinc.

If your contribution is not straightforward, please first discuss the change you wish to make by creating a new issue before making the change.

One of the project goals is to be easy to understand so, especially for github actions, try to keep things simple and to add comments whenever this is not possible.

Reporting issues

Issues have to be reported on our issues tracker. Please:

  • Check that the issue has not already been reported.
  • Try to use a clear title, and describe your problem with complete sentences.

Pull requests

Try to do one pull request per change.

Updating the changelog

Update the changes you have made in CHANGELOG file under the Unreleased section.

Add the changes of your pull request to one of the following subsections, depending on the types of changes defined by Keep a changelog:

  • Added for new features.
  • Changed for changes in existing functionality.
  • Deprecated for soon-to-be removed features.
  • Removed for now removed features.
  • Fixed for any bug fixes.
  • Security in case of vulnerabilities.

If the required subsection does not exist yet under Unreleased, create it!

Developing

Set up

This is no different than other Rust projects.

git clone https://github.com/devzbysiu/cargo-blinc
cd cargo-blinc
cargo build

Useful Commands

  • Build and run release version:

    cargo build --release && cargo run --release

  • Run Clippy:

    cargo clippy --all-targets --all-features -- -W clippy::pedantic -D warnings

  • Run all tests:

    cargo make test

  • Check to see if there are code formatting issues

    cargo fmt --all -- --check

  • Format the code in the project

    cargo fmt --all