86 lines
2.4 KiB
Markdown
86 lines
2.4 KiB
Markdown
# 🚀 How to Contribute to **cognee**
|
|
|
|
Thank you for investing time in contributing to our project! Here's a guide to get you started.
|
|
|
|
## 1. 🚀 Getting Started
|
|
|
|
### 🍴 Fork the Repository
|
|
|
|
To start your journey, you'll need your very own copy of **cognee**. Think of it as your own innovation lab. 🧪
|
|
|
|
1. Navigate to the [**cognee**](https://github.com/topoteretes/cognee) repository on GitHub.
|
|
2. In the upper-right corner, `click the 'Fork'` button.
|
|
|
|
### 🚀 Clone the Repository
|
|
|
|
Next, let's bring your newly forked repository to your local machine.
|
|
|
|
```shell
|
|
git clone https://github.com/<your-github-username>/cognee.git
|
|
```
|
|
|
|
## 2. 🛠️ Making Changes
|
|
|
|
### 🌟 Create a Branch
|
|
|
|
Get ready to channel your creativity. Begin by creating a new branch for your incredible features. 🧞♂️
|
|
|
|
```shell
|
|
git checkout -b feature/your-feature-name
|
|
```
|
|
|
|
### ✏️ Make Your Changes
|
|
|
|
Now's your chance to shine! Dive in and make your contributions. 🌠
|
|
|
|
## 3. 🚀 Submitting Changes
|
|
|
|
After making your changes, follow these steps
|
|
|
|
### ✅ Run the tests
|
|
|
|
to ensure your changes do not break the existing codebase:
|
|
|
|
```shell
|
|
python cognee/cognee/tests/test_library.py
|
|
```
|
|
|
|
|
|
### 🚢 Push your feature branch
|
|
|
|
```shell
|
|
# Add your changes to the staging area:
|
|
|
|
git add .
|
|
|
|
# Commit changes with an adequate description
|
|
git commit -m "Describe your changes here"
|
|
|
|
# Push your feature branch to your forked repository:
|
|
|
|
Copy code
|
|
git push origin feature/your-feature-name
|
|
```
|
|
|
|
### 🚀 Create a Pull Request
|
|
|
|
You're on the verge of completion! It's time to showcase your hard work. 🌐
|
|
|
|
1. Go to [**cognee**](https://github.com/topoteretes/cognee) on GitHub.
|
|
2. Hit the `"New Pull Request"` button.
|
|
3. Select the base branch `(main)` and the compare branch (the one with your features).
|
|
4. Craft a `compelling title` and provide a `detailed description` of your contributions. 🎩
|
|
|
|
## 4. 🔍 Review and Approval
|
|
|
|
The project maintainers will review your work, possibly suggest improvements, or request further details. Once you receive approval, your contributions will become part of **cognee**!
|
|
|
|
## 5. 📜 Code of Conduct
|
|
|
|
Ensure you adhere to the project's Code of Conduct throughout your participation.
|
|
|
|
## 6. 📫 Contact
|
|
|
|
If you need assistance or simply wish to connect, we're here for you. Contact us by filing an issue on the GitHub repository or by messaging us on our Discord server.
|
|
|
|
Thanks for helping to evolve **cognee**!
|