Skip to content

Commit 3dd1ca9

Browse files
authored
Merge pull request #127 from Saksham-Sirohi/firefox-guide-doc-add
Docs: added guide for firefox setup in documentation
2 parents f2eb1db + 25186c9 commit 3dd1ca9

File tree

1 file changed

+33
-11
lines changed

1 file changed

+33
-11
lines changed

README.md

Lines changed: 33 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,4 @@
1+
12
# SCRUM Helper
23

34
**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.
@@ -12,13 +13,30 @@
1213

1314
## How to install
1415

16+
### For Chrome:
17+
1518
1. Clone this repository to your local machine.
1619
2. Go to `chrome://extensions` on your chrome browser.
1720
3. Enable Developer Mode (toggle in the top-right) if not already.
1821
4. Click Load unpacked and select the `src` folder inside the cloned repo
1922
5. Click the Scrum Helper icon on your browser toolbar
2023
6. Fill in your settings in the popup (GitHub username, date range, etc.)
2124

25+
### For Firefox:
26+
27+
1. Clone this repository to your local machine.
28+
2. Open Firefox and navigate to `about:debugging`
29+
3. Click on "This Firefox" in the left sidebar
30+
4. Click "Load Temporary Add-on..."
31+
5. Navigate to the `src` folder inside the cloned repo and select the `manifest.json` file
32+
6. The extension will be loaded temporarily and will remain active only for the current browser session
33+
7. Click the Scrum Helper icon on your browser toolbar
34+
8. Fill in your settings in the popup (GitHub username, date range, etc.)
35+
36+
**Note for Firefox users:** The extension will be automatically removed when you close Firefox. You'll need to reload it each time you start a new browser session by repeating steps 2-5.
37+
38+
**Persistence Note:** If you need the extension to persist between sessions, use Firefox Developer Edition. You can enable persistence by setting `xpinstall.signatures.required` to `false` in the browser's configuration.
39+
2240
## Usage
2341

2442
### For Google Groups:
@@ -35,6 +53,7 @@
3553
- The extension will prefill scrum content for you to edit
3654

3755
### New Features
56+
3857
1. **Standalone Popup Interface**
3958
- Generate reports directly from the extension popup
4059
- Live preview of the report before sending
@@ -56,9 +75,9 @@ $ npm install
5675

5776
## Screenshots
5877

59-
![SCRUM](/docs/images/scrum.png)
78+
![SCRUM](docs/images/scrum.png)
6079

61-
![POPUP](/docs/images/popup.png)
80+
![POPUP](docs/images/popup.png)
6281

6382
![STANDALONE](docs/images/standalone.png)
6483

@@ -70,29 +89,32 @@ Scrum Helper is not limited to the [FOSSASIA](https://github.com/fossasia) organ
7089

7190
1. **Install the Extension**
7291

73-
- Load it into your browser through [Chrome Extension Developer Mode](https://developer.chrome.com/docs/extensions/mv3/getstarted/).
92+
* For Chrome: Load it into your browser through [Chrome Extension Developer Mode](https://developer.chrome.com/docs/extensions/mv3/getstarted/).
93+
* For Firefox: Load it as a temporary add-on through `about:debugging` as described above.
7494

7595
2. **Update the Organization**
96+
* Currently, the extension uses `org:fossasia` to fetch GitHub issues and PRs.
97+
* To make it work with your GitHub organization:
98+
* Open `scrumHelper.js` (or wherever the GitHub API URLs are defined).
99+
* Replace:
76100

77-
- Currently, the extension uses `org:fossasia` to fetch GitHub issues and PRs.
78-
- To make it work with your GitHub organization:
79-
- Open `scrumHelper.js` (or wherever the GitHub API URLs are defined).
80-
- Replace:
81101
```js
82102
+org:fossasia+
83103
```
104+
84105
with:
106+
85107
```js
86108
+org:your-org-name+
87109
```
110+
88111
**Example**
89112
![Code Snippet ](<Screenshot 2025-05-30 205822.png>)
90113

91114
3. **Build the Extension**
92-
93-
- Save your changes.
94-
- Rebuild or reload the extension in your browser (`chrome://extensions` → Refresh your extension).
95-
115+
* Save your changes.
116+
* For Chrome: Rebuild or reload the extension in your browser (`chrome://extensions` → Refresh your extension).
117+
* For Firefox: Reload the temporary add-on by going to `about:debugging`"This Firefox" → Click "Reload" next to your extension.
96118
4. **Get Customized SCRUM Reports**
97119
- The reports will now be generated using contributions from your organization.
98120

0 commit comments

Comments
 (0)