| <!-- |
| ~ Licensed to the Apache Software Foundation (ASF) under one |
| ~ or more contributor license agreements. See the NOTICE file |
| ~ distributed with this work for additional information |
| ~ regarding copyright ownership. The ASF licenses this file |
| ~ to you under the Apache License, Version 2.0 (the |
| ~ "License"); you may not use this file except in compliance |
| ~ with the License. You may obtain a copy of the License at |
| ~ |
| ~ http://www.apache.org/licenses/LICENSE-2.0 |
| ~ |
| ~ Unless required by applicable law or agreed to in writing, |
| ~ software distributed under the License is distributed on an |
| ~ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| ~ KIND, either express or implied. See the License for the |
| ~ specific language governing permissions and limitations |
| ~ under the License. |
| --> |
| |
| # Contributing |
| |
| ## Get Started |
| |
| This is a Rust project, so [rustup](https://rustup.rs/) is a great place to start. It provides an easy way to manage your Rust installation and toolchains. |
| |
| This is a pure Rust project, so only `cargo` is needed. Here are some common commands to get you started: |
| |
| - `cargo check`: Analyze the current package and report errors. |
| - `cargo fmt`: Format the current code according to the Rust style guidelines. |
| - `cargo build`: Compile the current package. |
| - `cargo clippy`: Catch common mistakes and improve code quality. |
| - `cargo test`: Run unit tests. |
| - `cargo bench`: Run benchmark tests. |
| |
| ## Setting up the Development Environment |
| |
| 1. Install Rust using `rustup`. Follow the instructions on the [rustup website](https://rustup.rs/) to install Rust on your system. |
| 2. Clone the repository to your local machine. |
| 3. Navigate to the project directory. |
| |
| ## Making Changes |
| |
| 1. Create a new branch for your changes. |
| 2. Make your changes and ensure that the code still compiles and passes all tests. |
| 3. Format your code using `cargo fmt` to ensure consistency with the project's code style. |
| |
| ## Submitting Changes |
| |
| 1. Once you are satisfied with your changes, push your branch to the remote repository. |
| 2. Open a pull request on the project's GitHub page. Provide a clear description of your changes and why they are necessary. |
| 3. Wait for reviews and address any feedback. Once the pull request is approved and merged, your changes will be part of the project. |
| |
| Thank you for contributing to this project! |