Skip to content

Commit

Permalink
contributing.md (#182)
Browse files Browse the repository at this point in the history
  • Loading branch information
danielchalef authored Sep 6, 2023
1 parent 99b43cc commit 6236c19
Showing 1 changed file with 102 additions and 0 deletions.
102 changes: 102 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,102 @@
# Contributing to Zep

Thank you for your interest in contributing to Zep! We appreciate your efforts and look forward to collaborating with you.

### Getting Started

1. **Fork and Clone**: Start by forking the [Zep repo](https://github.com/getzep/zep). Then, clone your fork locally:

```
git clone https://github.com/<your-github-username>/zep.git
```

2. **Set Upstream**: Keep your fork synced with the upstream repo by adding it as a remote:

```
git remote add upstream https://github.com/getzep/zep.git
```

3. **Create a Feature Branch**: Always create a new branch for your work. This helps in keeping your changes organized and easier for maintainers to review.

```
git checkout -b feature/your-feature-name
```

### Building Zep

Follow these steps to build Zep locally:

1. Navigate to the project root:

```
cd zep
```

2. Build the project:

```
make build
```

This will produce the binary in `./out/bin`.

### Running Tests

It's essential to ensure that your code passes all tests. Run the tests using:

```
make test
```

If you want to check the coverage, run:

```
make coverage
```

### Code Linting

Ensure your code adheres to our linting standards:

```
make lint
```

### Generating Swagger Docs

If you make changes to the API or its documentation, regenerate the Swagger docs:

```
make swagger
```

### Submitting Changes

1. **Commit Your Changes**: Use meaningful commit messages that describe the changes made.

```
git add .
git commit -m "Your detailed commit message"
```

2. **Push to Your Fork**:

```
git push origin feature/your-feature-name
```

3. **Open a Pull Request**: Navigate to the [Zep GitHub repo](https://github.com/getzep/zep) and click on "New pull request". Choose your fork and the branch you've been working on. Submit the PR with a descriptive message.

### Feedback

Maintainers will review your PR and provide feedback. If any changes are needed, make them in your feature branch and push to your fork. The PR will update automatically.

### Final Notes

- Always be respectful and kind.
- If you're unsure about something, ask. We're here to help.
- Once again, thank you for contributing to Zep!

---

If you encounter any issues or have suggestions, please open an issue!

0 comments on commit 6236c19

Please sign in to comment.