Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update CONTRIBUTING.md #464

Open
wants to merge 2 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
88 changes: 82 additions & 6 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,77 @@
# How to Contribute

## Install for Development
# 🌟 Contribute to Refact.ai

Welcome to the Refact.ai project! We’re excited to have you join our community. Whether you’re a first-time contributor or a seasoned developer, here are some impactful ways to get involved.

---

## 📚 Table of Contents

- [❤️ Ways to Contribute](#-ways-to-contribute)
- [🐛 Report Bugs](#-report-bugs)
- [✨ Suggest Features](#-suggest-features)
- [📖 Improving Documentation](#-improving-documentation)
- [Running the Documentation Server Locally](#running-the-documentation-server-locally)
- [Contributing To Code](#contributing-to-code)
- [Pre-Requisites](#pre-requistes)
- [Installation](#installation)
- [Fork the Repository](#fork-the-repository)
- [How to Create Good PR](#how-to-create-good-pr)
- [Install Linguist](#install-linguist)


---


# 🚀 Ways to Contribute

Our GitHub project board is a treasure trove of ideas on how you can contribute. These are just starting points—feel free to explore and propose your own initiatives!

*github project board soon*

avie66 marked this conversation as resolved.
Show resolved Hide resolved
---

## 🐛 Report Bugs

avie66 marked this conversation as resolved.
Show resolved Hide resolved
Encountered an issue? Help us improve Refact.ai by reporting bugs in issue section, make sure you label the issue with correct tag [here](https://github.com/smallcloudai/refact/issues)!

A comprehensive bug report includes:

- **Summary**: A brief overview of the issue.
- **Steps to Reproduce**: A detailed walkthrough of how to replicate the problem.
- **Expected vs. Actual Behavior**: Clarify what you expected to happen and what actually occurred.
- **Visuals**: Attach screenshots or videos to illustrate the issue.

---

## ✨ Suggest Features

We’re constantly evolving, and your ideas matter, make sure you label the issue with correct tag! To propose a new feature:

1. **Research Existing Proposals**: Check if your idea has already been suggested.
2. **Open a New Issue**: If it’s unique, please create a new issue.
3. **Provide Details**: Explain your feature idea and its potential impact on user experience.
4. **Engage with the Community**: Join us on the Refact.ai Discord.

---

## 📖 Improving Documentation

Help us make Refact.ai more accessible by contributing to our documentation, make sure you label the issue with correct tag! Create issues [here](https://github.com/smallcloudai/web_docs_refact_ai/issues).

### Running the Documentation Server Locally
Refer to this Repo : https://github.com/smallcloudai/web_docs_refact_ai
avie66 marked this conversation as resolved.
Show resolved Hide resolved


---

## Contributing To Code

### Pre-Requistes

Ensure you have the necessary tools and dependencies installed to kick off your development journey smoothly. Check our setup guide for detailed instructions.

### Installation

Clone this repo and install it for development:

Expand All @@ -25,20 +96,25 @@ DEBUG=1 python -m self_hosting_machinery.inference.inference_worker --model wiza

That should be enough to get started!

### Fork the Repository

If you plan to make changes, you need your own fork of the project -- clone that instead of
the main repo. Once you have your changes ready, commit them and push them to your fork. After
that you should be abloe to create a pull request for the main repository.
that you should be able to create a pull request for the main repository.

---

## Adding Toolbox Functions
### How to Create Good PR

UPDATE: toolbox is under reconstruction.
Check out this here : https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/getting-started/helping-others-review-your-changes


## Install Linguist
### Install Linguist

For fine tuning, files go through a pre filter. Follow instructions in
https://github.com/smallcloudai/linguist
to install it.

If you don't plan to debug fine tuning, you can skip this step.


Loading