We're excited that you're interested in contributing to XeroGraph! This document provides guidelines and information about contributing to this project. We hope to make the process as transparent and friendly as possible. Your contributions are essential for keeping XeroGraph great.
Before you start, you need to have Python installed along with the pandas, numpy, and matplotlib libraries. Familiarity with Git for version control is also recommended.
- Fork the XeroGraph repository.
- Clone your fork to your local machine:
git clone https://github.com/your-username/xerograph.git
- Set up a virtual environment in the project directory:
python -m venv env
source env/bin/activate
env\Scripts\activate
- Install the development dependencies:
pip install -r requirements_dev.txt
- Create a new branch for your changes:
git checkout -b name-of-your-branch
- Make your changes locally.
- Write or adapt tests as necessary.
- Run the tests to ensure they pass.
- Commit your changes:
git commit -am "Add a brief description of your change"
- Push your changes to your fork:
git push origin name-of-your-branch
- Go to the repository on GitHub.
- Select your fork.
- Press the 'Pull Request' button.
- Base the pull request against the main project's main branch.
- Describe the changes and why you made them.
- Submit the pull request.
Each pull request must be reviewed and approved by at least one of the project maintainers. We aim to review all pull requests within a week. If there are any comments or adjustments you need to make, we will let you know.
For any questions or major changes you are considering, please file an issue first to discuss what you would like to change. Join our community chat on [platform] to get more involved.
Contributors are expected to uphold the Code of Conduct, which promotes a welcoming and inclusive environment.
Thank you for contributing to XeroGraph! Every contribution is important and helps make this project what it is.