Contributing to SheetBuddy

Contributing to SheetBuddy#

We โค๏ธ contributions! Whether itโ€™s fixing bugs, adding new features, or improving documentation, your help is appreciated!

๐Ÿ”น Step 1: Fork & Clone the Repository First, fork the SheetBuddy repository and clone it to your local machine:

git clone https://github.com/AshishRogannagari/SheetBuddy.git
cd SheetBuddy

๐Ÿ”น Step 2: Create a Virtual Environment To keep dependencies isolated, create and activate a virtual environment:

# On macOS/Linux
python -m venv venv
source venv/bin/activate

# On Windows
python -m venv venv
venv\Scripts\activate

๐Ÿ“Œ Tip: If using conda, create an environment with:

conda create --name sheetbuddy_env python=3.9
conda activate sheetbuddy_env

๐Ÿ”น Step 3: Install Dependencies Now, install SheetBuddy in development mode along with documentation dependencies:

pip install -e .
pip install -r docs/requirements.txt

๐Ÿ”น Step 4: Make Your Changes - Follow best coding practices. - Add comments and docstrings for clarity. - Ensure your changes donโ€™t break existing functionality.

To check for issues, run:

pytest   # If tests are available
flake8   # To check for linting errors

๐Ÿ”น Step 5: Submit a Pull Request (PR) Once happy with your changes:

  1. Commit & Push Changes

    git add .
    git commit -m "Your meaningful commit message"
    git push origin your-branch
    
  2. Create a Pull Request on GitHub

    • Open a PR to main branch.

    • Describe your changes clearly.

    • Wait for review & feedback.

๐Ÿš€ Thank you for contributing to SheetBuddy!

Weโ€™ll review your PR and get back to you soon. Happy coding! ๐Ÿ˜Š