Contributing to BackdoorMBTI
Thank you for your interest in contributing to BackdoorMBTI! We appreciate contributions of all types, including code, documentation, and ideas. This guide will help you get started and understand how to contribute effectively.
Getting Started
To contribute to BackdoorMBTI, follow these steps:
Fork the repository.
Clone the fork to your local machine.
Create a new branch for your contribution.
Make your changes, ensuring your work follows our guidelines.
Push your changes to your fork and submit a pull request.
You can find our repository here: https://anonymous.4open.science/r/BackdoorMBTI-D6A1/README.md Setting up the Environment —————————
Clone the repository:
git clone https://anonymous.4open.science/r/BackdoorMBTI-D6A1/README.md cd BackdoorMBTI
Create a virtual environment:
python3 -m venv venv source venv/bin/activate
Install dependencies:
pip install -r requirements.txt
Code Contributions
We follow a few coding standards to ensure that BackdoorMBTI maintains high quality and consistency. Please adhere to the following guidelines:
PEP 8: Ensure your code follows the PEP 8 Python coding standard.
Unit Tests: Write unit tests for any new functionality or changes to existing functionality.
Type Annotations: Use type annotations where possible to ensure better code clarity and maintainability.
Linting: Run the linter before submitting a pull request:
flake8
Documentation
If you are contributing documentation, we follow the reStructuredText (reST) format for our docs. Please ensure that you:
Follow the same structure and tone as existing documentation.
Use clear, concise language.
Add examples where applicable.
Adding or Updating Documentation
To add or update documentation:
Edit the relevant .rst files in the docs/ directory.
Build the documentation locally to ensure there are no formatting errors:
cd docs make html
Testing Your Changes
We encourage you to run the test suite before submitting your contribution to ensure everything is functioning correctly.
Install test dependencies:
pip install -r test-requirements.txt
Run tests:
pytest
Submitting Your Contribution
Once you have made your changes and verified that they meet the contribution guidelines:
Commit your changes: Make sure to write a meaningful commit message.
git commit -m "Description of your changes"
Push your branch to your fork:
git push origin your-branch-name
Submit a pull request: Go to the GitHub repository, navigate to the “Pull Requests” tab, and submit your PR.
We will review your contribution and provide feedback if necessary. If your pull request is accepted, it will be merged into the main codebase.
Questions
If you have any questions, feel free to open an issue or reach out to the project maintainers directly.