# Contribution guidelines
First off, thank you for considering contributing to `cargo-sync-rdme`.
If your contribution is not straightforward, please first discuss the change you
wish to make by creating a new issue before making the change.
## Reporting issues
Before reporting an issue on the
[issue tracker](https://github.com/gifnksm/cargo-sync-rdme/issues),
please check that it has not already been reported by searching for some related
keywords.
## Pull requests
Try to do one pull request per change.
### Updating the changelog
Add your changes to the **Unreleased** section of [CHANGELOG](https://github.com/gifnksm/cargo-sync-rdme/blob/main/CHANGELOG.md).
Add the changes from your pull request to one of the following subsections,
depending on the types of changes defined by
[Keep a changelog](https://keepachangelog.com/en/1.0.0/):
- `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.
```console
git clone https://github.com/gifnksm/cargo-sync-rdme
cd cargo-sync-rdme
```
### Useful Commands
- Build and run release version:
```console
cargo build --release && cargo run --release
```
- Run all CI checks:
```console
just ci
```
See `just --list` for more commands.