From a3bf9e246483155e3ae96ab6027b5f35ffe2997d Mon Sep 17 00:00:00 2001 From: Lukasz Kolodziejczyk Date: Tue, 4 Feb 2025 11:46:34 +0100 Subject: [PATCH 1/2] add CONTRIBUTING.md --- CONTRIBUTING.md | 69 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 69 insertions(+) create mode 100644 CONTRIBUTING.md diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..0a9ba4b --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,69 @@ +# Contributing to Synthetic Data Quality Assurance + +Thanks for your interest in contributing to Synthetic Data Quality Assurance! Follow these guidelines to set up your environment and streamline your contributions. + +## Setup + +1. **Clone the repository**: + ```bash + git clone https://github.com/mostly-ai/mostlyai-qa.git + cd mostlyai-qa + ``` + If you don’t have direct write access to `mostlyai-qa`, fork the repository first and clone your fork: + ```bash + git clone https://github.com//mostlyai-qa.git + cd mostlyai-qa + ``` + +2. **Install `uv` (if not installed already)**: + ```bash + curl -LsSf https://astral.sh/uv/install.sh | sh + ``` + For alternative installation methods, visit the [uv installation guide](https://docs.astral.sh/uv/getting-started/installation/). + +3. **Create a virtual environment and install dependencies**: + ```bash + uv sync --frozen --python=3.10 + source .venv/bin/activate + ``` + +4. **Install pre-commit hooks**: + ```bash + pre-commit install + ``` + +## Development Workflow + +1. **Ensure your local `main` branch is up to date**: + ```bash + git checkout main + git reset --hard origin/main + git pull origin main + ``` + +2. **Create a new feature or bugfix branch**: + ```bash + git checkout -b my-feature-branch + ``` + +3. **Implement your changes.** + +4. **Run tests and pre-commit hooks**: + ```bash + pytest + pre-commit run + ``` + +5. **Commit your changes with a descriptive message**: + ```bash + git add . + git commit -m "feat: add a clear description of your feature" + ``` + Follow the [Conventional Commits](https://gist.github.com/qoomon/5dfcdf8eec66a051ecd85625518cfd13) format. + +6. **Push your changes**: + ```bash + git push origin my-feature-branch + ``` + +7. **Open a pull request on GitHub.** From 864b75f376389c8a181284a46acb84e7b0c6dddf Mon Sep 17 00:00:00 2001 From: Lukasz Kolodziejczyk Date: Tue, 4 Feb 2025 11:49:20 +0100 Subject: [PATCH 2/2] dot --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index d984010..1584c4a 100644 --- a/README.md +++ b/README.md @@ -20,7 +20,7 @@ The latest release of `mostlyai-qa` can be installed via pip: pip install -U mostlyai-qa ``` -On Linux, one can explicitly install `mostlyai-qa[cpu]` or `mostlyai-qa[gpu]`, for CPU-only or CUDA support respectively +On Linux, one can explicitly install `mostlyai-qa[cpu]` or `mostlyai-qa[gpu]`, for CPU-only or CUDA support respectively. ## Quick Start