Skip to content

Commit

Permalink
Merge pull request #12 from chaoss/faithkovi
Browse files Browse the repository at this point in the history
rename and edit contributing.md file
  • Loading branch information
kaxada authored Jul 20, 2023
2 parents 4a90c8c + b0366e7 commit 1cb9e91
Showing 1 changed file with 35 additions and 22 deletions.
57 changes: 35 additions & 22 deletions CONTRIBUTIONS.md → CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# Contributing.md

Welcome to our project repository! We're thrilled that you're interested in contributing to our project, which utilizes the powerful capabilities of GitHub Copilot. This document provides guidelines and instructions on how you can contribute effectively to the project.


## Introduction

We use the following tools and frameworks in this project:
Expand All @@ -14,15 +14,13 @@ We use the following tools and frameworks in this project:
- Component Library: Flowbite
- Icon Pack: Material Symbols by Google
- Using GitHub Copilot
- We are using GitHub Copilot to assist with the development process. Please ensure that you have the GitHub Copilot extension installed in your code editor for improved coding assistance.

- We are using GitHub Copilot to assist with the development process. Please ensure that you have the GitHub Copilot extension installed in your code editor for improved coding assistance.
## Installation

To run the project in a local environment, ensure the following are installed:

- Nodejs
- Npm

## Setup Github Copilot

GitHub Copilot is available as an extension for popular code editors such as Visual Studio Code. To install GitHub Copilot, follow these steps:
Expand All @@ -33,9 +31,7 @@ GitHub Copilot is available as an extension for popular code editors such as Vis
- Click on the "Install" button next to the GitHub Copilot extension.
- Wait for the installation to complete, and then click on the "Reload" button to activate the extension.
- Usage: Once GitHub Copilot is installed, it automatically starts providing code suggestions as you type in your code editor. It learns from millions of lines of public code and your own code to generate accurate and context-aware suggestions.

## How to contribute to the project

## How to contribute to the project
- **Fix an Issue**

If you want to fix an open issue, leave a comment on it to show. This is done to avoid having multiple people working on the same issue unknowingly.
Expand All @@ -46,36 +42,53 @@ In the event that you're encountering an issue or have an inquiry you'd like ass
Source Code

- Fork and clone this project repository
$ git clone https://github.com/<YOUR_USERNAME>/GitHub-Copilot-Hackathon-Project.git
```
$ git clone https://github.com/<YOUR_USERNAME>/GitHub-Copilot-Hackathon-Project.git
```
- Change to the project directory
$ cd GitHub-Copilot-Hackathon-Project
```
$ cd GitHub-Copilot-Hackathon-Project
```
- Install the project dependencies
$ npm install
```
$ npm install
```
- Create a branch for your changes.
$ git checkout -b my-new-branch
```
$ git checkout -b my-new-branch
```
- Make your changes
- Run the project locally to test your changes
$ npm run dev
```
$ npm run dev
```
- Commit the change(s) using a [descriptive commit message](https://www.freecodecamp.org/news/how-to-write-better-git-commit-messages/) and [signing off the commit](https://github.com/chaoss/chaoss-slack-bot/blob/main/CONTRIBUTING.md#signing-off-on-commits)
$ git add .
$ git commit -s -m "descriptive commit message"
$ git push -u origin my-new-branch
```
$ git add .
$ git commit -s -m "descriptive commit message"
$ git push -u origin my-new-branch
```
- Submit a pull request

Upon submitting a pull request, one of the maintainers will review your pull request and give feedback on changes or merge your pull requested.

> Keep in mind to regularly synchronize your fork with the main branch. To do this, make sure you are in the project's root folder, and the branch should be the main branch. Run the command:
$ git remote add upstream https://github.com/chaoss/chaoss-slack-bot.git
```
$ git remote add upstream https://github.com/chaoss/chaoss-slack-bot.git
```

Now that your upstream is set up on your local machine, whenever you need to create a new branch to make changes, make sure your main branch is in sync with the main repository by typing:

$ git pull upstream main
$ git push origin main
```
$ git pull upstream main
$ git push origin main
```

Thank you for your contributions! We appreciate your time and effort in making this project better.

## Resources

- Project Design -> https://www.figma.com/file/mALWb4e0vqfBbtRwop3g16/Afos?type=design&node-id=44-930&mode=design&t=XHbTvPKU9rzZ0NZU-0


- Code of Conduct -> https://github.com/chaoss/.github/blob/main/CODE_OF_CONDUCT.md



0 comments on commit 1cb9e91

Please sign in to comment.