Skip to content

Commit

Permalink
Merge pull request #18 from chrissimpkins/contributing-docs
Browse files Browse the repository at this point in the history
Add CONTRIBUTING.md
  • Loading branch information
chrissimpkins authored Dec 26, 2023
2 parents 5f5606f + d61f147 commit c0a5b77
Show file tree
Hide file tree
Showing 2 changed files with 47 additions and 44 deletions.
46 changes: 46 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,46 @@
# Contributing to siz

We welcome contributions to the `siz` project under the Apache License v2.0. Whether you're looking to fix bugs, add new features, or improve documentation, your help is greatly appreciated.

Here's how you can contribute:

1. **Fork the Repository**: Fork the `siz` repository to your GitHub account.

2. **Clone the Repository**: Clone the forked repository to your local machine.

```text
git clone https://github.com/<your-username>/siz.git
```
3. **Create a New Branch**: Create a new branch for your changes.
```text
git checkout -b add-new-feature
```
4. **Make Your Changes**: Make changes to the code or documentation.
5. **Commit Your Changes**: Commit your changes to your branch. Include a commit message that briefly describes your changes.
```text
git commit -m "Add new feature"
```
6. **Push Your Changes**: Push your changes to your forked repository on GitHub.
```text
git push origin add-new-feature
```
7. **Submit a Pull Request**: Follow the [GitHub Pull Request instructions](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) to create a new pull request with your proposed changes.
**Before submitting a pull request**, please ensure your code compiles and all tests, including the clippy lints, pass. If you're adding a new feature, please add tests that cover the new feature.
You can run the following commands in the root of your downstream source repository to execute these tests before you submit your pull request:
```text
cargo test
cargo clippy
```

Please feel free to reach out if you have any questions or need help contributing.
45 changes: 1 addition & 44 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -118,50 +118,7 @@ Please use the GitHub issue tracker to report bugs or other issues. Thanks!

## Contributing

We welcome contributions to the `siz` project under the Apache License v2.0. Whether you're looking to fix bugs, add new features, or improve documentation, your help is greatly appreciated.

Here's how you can contribute:

1. **Fork the Repository**: Fork the `siz` repository to your GitHub account.

2. **Clone the Repository**: Clone the forked repository to your local machine.

```text
git clone https://github.com/<your-username>/siz.git
```
3. **Create a New Branch**: Create a new branch for your changes.
```text
git checkout -b add-new-feature
```
4. **Make Your Changes**: Make changes to the code or documentation.
5. **Commit Your Changes**: Commit your changes to your branch. Include a commit message that briefly describes your changes.
```text
git commit -m "Add new feature"
```
6. **Push Your Changes**: Push your changes to your forked repository on GitHub.
```text
git push origin add-new-feature
```
7. **Submit a Pull Request**: Follow the [GitHub Pull Request instructions](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request) to create a new pull request with your proposed changes.
**Before submitting a pull request**, please ensure your code compiles and all tests, including the clippy lints, pass. If you're adding a new feature, please add tests that cover the new feature.
You can run the following commands in the root of your downstream source repository to execute these tests before you submit your pull request:
```text
cargo test
cargo clippy
```

Please feel free to reach out if you have any questions or need help contributing.
Please see [CONTRIBUTING.md](CONTRIBUTING.md).

## License

Expand Down

0 comments on commit c0a5b77

Please sign in to comment.