Skip to content

Commit

Permalink
move contributing documentation to CONTRIBUTING.md
Browse files Browse the repository at this point in the history
  • Loading branch information
chrissimpkins committed Dec 26, 2023
1 parent b7df061 commit d61f147
Show file tree
Hide file tree
Showing 2 changed files with 45 additions and 44 deletions.
44 changes: 44 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,2 +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 d61f147

Please sign in to comment.