Skip to content

Commit 865ebf8

Browse files
authored
Merge pull request #96 from Preeti9764/readme-changes
docs: Add instructions for configuring Scrum Helper with custom GitHub organizations
2 parents 67925df + ab6af71 commit 865ebf8

File tree

2 files changed

+48
-7
lines changed

2 files changed

+48
-7
lines changed

README.md

Lines changed: 48 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,13 @@
22

33
**SCRUM Helper** is a Chrome extension designed to simplify writing scrums in Google Groups for FOSSASIA projects. By adding your GitHub username, date range, and other options, it automatically fetches your PRs, Issues, and reviewed PRs via the GitHub API and pre-fills the scrum. You can then edit the scrum to fit your needs.
44

5-
65
![SCRUMLOGO](docs/images/scrumhelper-png.png)
76

87
## Features
98

10-
- Fetches your GitHub PRs, Issues, and reviewed PRs
11-
- Auto-generates scrum updates
12-
- Supports Google Groups, Gmail, Yahoo, and Outlook compose windows
9+
- Fetches your GitHub PRs, Issues, and reviewed PRs
10+
- Auto-generates scrum updates
11+
- Supports Google Groups, Gmail, Yahoo, and Outlook compose windows
1312

1413
## How to install
1514

@@ -21,16 +20,19 @@
2120
6. Fill in your settings in the popup (GitHub username, date range, etc.)
2221

2322
## Usage
24-
### For Google Groups:
23+
24+
### For Google Groups:
25+
2526
- Open Google Groups New Topic
2627
- Start a New Conversation
2728
- Refresh the page to apply the Scrum Helper settings
2829
- Use the pre-filled scrum and edit as needed
2930

3031
### For Gmail, Yahoo, and Outlook:
31-
- Open the Compose window.
32+
33+
- Open the Compose window.
3234
- Ensure the Scrum Helper settings are applied (follow step 6 above)
33-
- The extension will prefill scrum content for you to edit
35+
- The extension will prefill scrum content for you to edit
3436

3537
## Setting up the code locally
3638

@@ -39,12 +41,51 @@ $ git clone https://github.com/fossasia/scrum_helper/
3941
$ cd scrum_helper
4042
$ npm install
4143
```
44+
4245
## Screenshots
46+
4347
![SCRUM](/docs/images/scrum.png)
4448

4549
![POPUP](/docs/images/popup.png)
4650

51+
## Using Scrum Helper with Your Own GitHub Organization
52+
53+
Scrum Helper is not limited to the [FOSSASIA](https://github.com/fossasia) organization. You can easily configure it to fetch and generate SCRUM reports for your own GitHub organization or repositories.
54+
55+
### Steps to Set It Up for Your Organization
56+
57+
1. **Install the Extension**
58+
59+
- Load it into your browser through [Chrome Extension Developer Mode](https://developer.chrome.com/docs/extensions/mv3/getstarted/).
60+
61+
2. **Update the Organization**
62+
63+
- Currently, the extension uses `org:fossasia` to fetch GitHub issues and PRs.
64+
- To make it work with your GitHub organization:
65+
- Open `scrumHelper.js` (or wherever the GitHub API URLs are defined).
66+
- Replace:
67+
```js
68+
+org:fossasia+
69+
```
70+
with:
71+
```js
72+
+org:your-org-name+
73+
```
74+
**Example**
75+
![Code Snippet ](<Screenshot 2025-05-30 205822.png>)
76+
77+
3. **Build the Extension**
78+
79+
- Save your changes.
80+
- Rebuild or reload the extension in your browser (`chrome://extensions` → Refresh your extension).
81+
82+
4. **Get Customized SCRUM Reports**
83+
- The reports will now be generated using contributions from your organization.
84+
85+
---
86+
4787
## About contributing
88+
4889
- Follow the Issues and PRs templates as far as possible.
4990
- If you want to make a PR, please mention in the corresponding issue that you are working on it.
5091
- Before making a PR, ensure your code is properly formatted and linted:

Screenshot 2025-05-30 205822.png

34.6 KB
Loading

0 commit comments

Comments
 (0)