Skip to content

Commit 567acd6

Browse files
docs: add CONTRIBUTING.md (#98)
1 parent 42e72ed commit 567acd6

File tree

2 files changed

+70
-1
lines changed

2 files changed

+70
-1
lines changed

CONTRIBUTING.md

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
# Contributing to Synthetic Data Quality Assurance
2+
3+
Thanks for your interest in contributing to Synthetic Data Quality Assurance! Follow these guidelines to set up your environment and streamline your contributions.
4+
5+
## Setup
6+
7+
1. **Clone the repository**:
8+
```bash
9+
git clone https://github.com/mostly-ai/mostlyai-qa.git
10+
cd mostlyai-qa
11+
```
12+
If you don’t have direct write access to `mostlyai-qa`, fork the repository first and clone your fork:
13+
```bash
14+
git clone https://github.com/<your-username>/mostlyai-qa.git
15+
cd mostlyai-qa
16+
```
17+
18+
2. **Install `uv` (if not installed already)**:
19+
```bash
20+
curl -LsSf https://astral.sh/uv/install.sh | sh
21+
```
22+
For alternative installation methods, visit the [uv installation guide](https://docs.astral.sh/uv/getting-started/installation/).
23+
24+
3. **Create a virtual environment and install dependencies**:
25+
```bash
26+
uv sync --frozen --python=3.10
27+
source .venv/bin/activate
28+
```
29+
30+
4. **Install pre-commit hooks**:
31+
```bash
32+
pre-commit install
33+
```
34+
35+
## Development Workflow
36+
37+
1. **Ensure your local `main` branch is up to date**:
38+
```bash
39+
git checkout main
40+
git reset --hard origin/main
41+
git pull origin main
42+
```
43+
44+
2. **Create a new feature or bugfix branch**:
45+
```bash
46+
git checkout -b my-feature-branch
47+
```
48+
49+
3. **Implement your changes.**
50+
51+
4. **Run tests and pre-commit hooks**:
52+
```bash
53+
pytest
54+
pre-commit run
55+
```
56+
57+
5. **Commit your changes with a descriptive message**:
58+
```bash
59+
git add .
60+
git commit -m "feat: add a clear description of your feature"
61+
```
62+
Follow the [Conventional Commits](https://gist.github.com/qoomon/5dfcdf8eec66a051ecd85625518cfd13) format.
63+
64+
6. **Push your changes**:
65+
```bash
66+
git push origin my-feature-branch
67+
```
68+
69+
7. **Open a pull request on GitHub.**

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ The latest release of `mostlyai-qa` can be installed via pip:
2020
pip install -U mostlyai-qa
2121
```
2222

23-
On Linux, one can explicitly install `mostlyai-qa[cpu]` or `mostlyai-qa[gpu]`, for CPU-only or CUDA support respectively
23+
On Linux, one can explicitly install `mostlyai-qa[cpu]` or `mostlyai-qa[gpu]`, for CPU-only or CUDA support respectively.
2424

2525
## Quick Start
2626

0 commit comments

Comments
 (0)