Skip to content

Commit 4950c62

Browse files
committed
Initial Commit
1 parent 36ff038 commit 4950c62

20 files changed

Lines changed: 988 additions & 5 deletions

README.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ GitQ is aimed to effectively improve developers' experience while using Github a
1717

1818

1919
## Snapshot of GitQ Assessment Report:
20-
<img alt="assesment-report" src="https://kowndinya2000.github.io/gitq-resources.github.io/assessment-report-short.png">
20+
<img alt="assesment-report" src="https://kowndinya2000.github.io/gitq-resources.github.io/GitQ-ICPC-architecture.png">
2121

2222
## What's inside GitQ Repository:
2323
In the GitQ folder,
@@ -36,10 +36,9 @@ In the GitQ folder,
3636
9. GitQ Plugin gets installed on Chrome.
3737

3838
## Steps to use GitQ:
39-
1. Open the folder ```server```, and follow the instructions as stated in its [Readme.](https://github.com/gitq-for-github/plugin/blob/master/server/README.md)
40-
2. Navigate to GitHub (https://github.com/)
41-
3. Navigate to repository for which the metric-assessment is done via server.
42-
4. You will see visual badges augumented to the repository page.
39+
1. Navigate to GitHub (https://github.com/)
40+
2. Navigate to repository for which the metric-assessment is done automatically.
41+
3. You will see visual badges augumented to the repository page.
4342

4443

4544
## How to contribute to GitQ
Lines changed: 46 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,46 @@
1+
# GitQ-BACKUP VERSION
2+
3+
## What is GitQ?
4+
GitQ has a Chrome plugin to augment GitHub with badges that deliver visual cues quantifying the
5+
project’s architecture and maintenance.
6+
7+
## Features of GitQ Plugins:
8+
1. Analyzes the repository with respect to 6 source code metrics and 4 maintenance metrics
9+
2. Metrics and their scores are shown as badges
10+
3. Insight icons are displayed at the end to provide additional information about each maintenance metric
11+
12+
## Uses of GitQ:
13+
GitQ is aimed to effectively improve developers' experience while using Github and assist them to identify the right repository to fork and use or to contribute to.
14+
15+
## Overview diagram of GitQ (Backup Version with Server & Plugin dissociated as separate unconnected entities):
16+
<img alt="approach" src="https://kowndinya2000.github.io/buffer-2.github.io/GitQ-workflow2.png">
17+
18+
19+
## Snapshot of GitQ Assessment Report:
20+
<img alt="assesment-report" src="https://kowndinya2000.github.io/gitq-resources.github.io/assessment-report-short.png">
21+
22+
## What's inside GitQ Repository:
23+
In the GitQ folder,
24+
"background.js" file contains all the source code related to analyzing repository and displaying badges.
25+
"manifest.json" file includes the url that triggers start of GitQ.
26+
27+
## Steps to install GitQ's Plugin:
28+
1. Download the repository on your local machine.
29+
2. Unzip the folder and extract it to a location of your choice on your PC.
30+
3. Now, open Google Chrome and Go to Settings
31+
4. Select Extensions or navigate to chrome://extensions
32+
5. Turn on Developer Mode at the right side top corner of chrome://extensions
33+
6. Click on “Load unpacked”
34+
7. A popup appears to select folder
35+
8. Select GitQ folder from the location you previously extracted to, and click on OK.
36+
9. GitQ Plugin gets installed on Chrome.
37+
38+
## Steps to use GitQ:
39+
1. Open the folder ```server```, and follow the instructions as stated in its [Readme.](https://github.com/gitq-for-github/plugin/blob/master/server/README.md)
40+
2. Navigate to GitHub (https://github.com/)
41+
3. Navigate to repository for which the metric-assessment is done via server.
42+
4. You will see visual badges augumented to the repository page.
43+
44+
45+
## How to contribute to GitQ
46+
We will be very happy to receive any kind of contributions. Incase of a bug or an enhancement idea or a feature improvement idea, please open an issue or a pull request. Incase of any queries or if you would like to give any suggestions, please feel free to contact Akhila Sri Manasa Venigalla (cs19d504@iittp.ac.in) or Kowndinya Boyalakuntla (cs17b032@iittp.ac.in) or Sridhar Chimalakonda (ch@iittp.ac.in) of RISHA Lab, IIT Tirupati, India.

0 commit comments

Comments
 (0)