Skip to content

Commit b7a7e81

Browse files
committed
Merge branch 'ui2' of https://github.com/vedansh-5/scrum_helper into ui2
2 parents ee7b950 + 2b602d7 commit b7a7e81

File tree

12 files changed

+252
-30
lines changed

12 files changed

+252
-30
lines changed

.github/ISSUE_TEMPLATE.md

Lines changed: 0 additions & 15 deletions
This file was deleted.

.github/ISSUE_TEMPLATE/bug_report.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
---
2+
name: Bug Report
3+
about: Report a bug or unexpected behavior
4+
title: "[Bug] "
5+
labels: bug
6+
assignees: ''
7+
8+
---
9+
10+
## Bug Description
11+
A clear and concise description of what the bug is.
12+
13+
### Steps to Reproduce
14+
Steps to reproduce the behavior:
15+
1. Go to '...'
16+
2. Click on '...'
17+
3. Scroll down to '...'
18+
4. See error
19+
20+
### Expected Behavior
21+
A clear and concise description of what you expected to happen.
22+
23+
### Actual Behavior
24+
A clear and concise description of what actually happened.
25+
26+
### Screenshots
27+
If applicable, add screenshots to help explain your problem.
28+
29+
### Additional Context
30+
Add any other context about the problem here.
31+
32+
---
33+
34+
## Contribution Checklist
35+
- [ ] I have searched existing issues to ensure this bug hasn't been reported
36+
- [ ] I have provided clear reproduction steps
37+
- [ ] I have included relevant environment details
38+
- [ ] I have described both expected and actual behavior
Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,33 @@
1+
---
2+
name: Feature or Enhancement Request
3+
about: Suggest a new feature or improvement to existing functionality
4+
title: '[Enhancement]: <short description>'
5+
labels: ['enhancement']
6+
assignees: ''
7+
---
8+
9+
## Enhancement Summary
10+
A clear and concise description of the enhancement or feature you'd like to see.
11+
12+
### Motivation
13+
Why is this feature needed? What problem does it solve or what value does it add?
14+
15+
### Proposed Solution
16+
Describe your idea or how you would like it to work.
17+
18+
### Alternatives Considered
19+
Have you thought of any other ways to solve the problem?
20+
21+
### Screenshots / Mockups
22+
If applicable, add visuals or examples of how this could look/work.
23+
24+
### Additional Context
25+
Any other relevant information or use cases.
26+
27+
---
28+
29+
## Contribution Checklist
30+
- [ ] I have checked existing enhancement requests
31+
- [ ] I have clearly described the proposed change
32+
- [ ] I have explained the motivation and context
33+
- [ ] I am willing to help implement this feature (optional)

.github/PULL_REQUEST_TEMPLATE.md

Lines changed: 29 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,31 @@
1-
Fixes issue #[Add issue number here. If you do not solve the issue entirely, please change the message e.g. "First steps for issues #IssueNumber]
1+
### 📌 Fixes
22

3-
Changes: [Add here what changes were made in this issue and if possible provide links.]
3+
Fixes #<issue-number> (Use "Fixes", "Closes", or "Resolves" for automatic closing)
44

5-
Screenshots for the change:
5+
---
6+
7+
### 📝 Summary of Changes
8+
9+
- Short description of what was changed
10+
- Include links to related issues/discussions if any
11+
12+
---
13+
14+
### 📸 Screenshots / Demo (if UI-related)
15+
16+
_Add screenshots, video, or link to deployed preview if applicable_
17+
18+
---
19+
20+
### ✅ Checklist
21+
22+
- [ ] I’ve tested my changes locally
23+
- [ ] I’ve added tests (if applicable)
24+
- [ ] I’ve updated documentation (if applicable)
25+
- [ ] My code follows the project’s code style guidelines
26+
27+
---
28+
29+
### 👀 Reviewer Notes
30+
31+
_Add any special notes for the reviewer here_

.github/release-drafter.yml

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
name-template: 'v$RESOLVED_VERSION 🌈'
2+
tag-template: 'v$RESOLVED_VERSION'
3+
categories:
4+
- title: '🚀 Features'
5+
labels:
6+
- 'feature'
7+
- 'enhancement'
8+
- title: '🐛 Bug Fixes'
9+
labels:
10+
- 'fix'
11+
- 'bugfix'
12+
- 'bug'
13+
- title: '🧰 Maintenance'
14+
labels: 'chore'
15+
change-template: '- $TITLE @$AUTHOR (#$NUMBER)'
16+
change-title-escapes: '\<*_&' # You can add # and @ to disable mentions, and add ` to disable code blocks.
17+
version-resolver:
18+
major:
19+
labels:
20+
- 'major'
21+
minor:
22+
labels:
23+
- 'minor'
24+
patch:
25+
labels:
26+
- 'patch'
27+
default: patch
28+
template: |
29+
## Changes
30+
31+
$CHANGES

.github/workflows/release-drafter.yml

Lines changed: 42 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,42 @@
1+
name: Release Drafter
2+
3+
on:
4+
push:
5+
# branches to consider in the event; optional, defaults to all
6+
branches:
7+
- master
8+
9+
# pull_request event is required only for autolabeler
10+
pull_request:
11+
# Only following types are handled by the action, but one can default to all as well
12+
types: [opened, reopened, synchronize]
13+
# pull_request_target event is required for autolabeler to support PRs from forks
14+
# pull_request_target:
15+
# types: [opened, reopened, synchronize]
16+
17+
permissions:
18+
contents: read
19+
20+
jobs:
21+
update_release_draft:
22+
permissions:
23+
# write permission is required to create a github release
24+
contents: write
25+
# write permission is required for autolabeler
26+
# otherwise, read permission is required at least
27+
pull-requests: write
28+
runs-on: ubuntu-latest
29+
steps:
30+
# (Optional) GitHub Enterprise requires GHE_HOST variable set
31+
#- name: Set GHE_HOST
32+
# run: |
33+
# echo "GHE_HOST=${GITHUB_SERVER_URL##https:\/\/}" >> $GITHUB_ENV
34+
35+
# Drafts your next Release notes as Pull Requests are merged into "master"
36+
- uses: release-drafter/release-drafter@v6.1.0
37+
# (Optional) specify config name to use, relative to .github/. Default: release-drafter.yml
38+
# with:
39+
# config-name: my-config.yml
40+
# disable-autolabeler: true
41+
env:
42+
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

README.md

Lines changed: 78 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,23 +1,50 @@
11
# SCRUM Helper
22

3-
This chrome extension helps you to write scrums in google groups for FOSSASIA related projects. You need to add your github username, dates, and other options. It fetches your PRs, Issues, and the PRs you reviewed from Github API, and prefills the SCRUM. You can edit the scrum further to meet your needs.
3+
**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

55
![SCRUMLOGO](docs/images/scrumhelper-png.png)
66

7+
## Features
8+
9+
- Fetches your GitHub PRs, Issues, and reviewed PRs
10+
- Auto-generates scrum updates
11+
- Supports Google Groups, Gmail, Yahoo, and Outlook compose windows
12+
713
## How to install
814

915
1. Clone this repository to your local machine.
1016
2. Go to `chrome://extensions` on your chrome browser.
11-
3. Turn on developer mode if not already on.
12-
4. Load unpacked extension from `src` folder.
13-
5. Click on the Scrum Helper icon you see on your browser toolbar.
14-
6. Fill in the settings in the popup.
15-
7. **For Google Groups:**
16-
- Open https://groups.google.com/forum/#!newtopic/<groupname> and start a New Conversation.
17-
8. Refresh the page to apply the new settings.
18-
9. **For Gmail, Yahoo, and Outlook:**
19-
- Open the Compose window.
20-
- Follow Step 8 to ensure the settings take effect.
17+
3. Enable Developer Mode (toggle in the top-right) if not already.
18+
4. Click Load unpacked and select the `src` folder inside the cloned repo
19+
5. Click the Scrum Helper icon on your browser toolbar
20+
6. Fill in your settings in the popup (GitHub username, date range, etc.)
21+
22+
## Usage
23+
24+
### For Google Groups:
25+
26+
- Open Google Groups New Topic
27+
- Start a New Conversation
28+
- Refresh the page to apply the Scrum Helper settings
29+
- Use the pre-filled scrum and edit as needed
30+
31+
### For Gmail, Yahoo, and Outlook:
32+
33+
- Open the Compose window.
34+
- Ensure the Scrum Helper settings are applied (follow step 6 above)
35+
- The extension will prefill scrum content for you to edit
36+
37+
### New Features
38+
1. **Standalone Popup Interface**
39+
- Generate reports directly from the extension popup
40+
- Live preview of the report before sending
41+
- Rich text formatting with clickable links
42+
- Copy report to clipboard with proper formatting
43+
44+
### Usage Standalone
45+
- Click on `GENERATE` button to generate the scrum preview.
46+
- Edit it in the window.
47+
- Copy the rich HTML using the `COPY` button.
2148

2249
## Setting up the code locally
2350

@@ -26,12 +53,52 @@ $ git clone https://github.com/fossasia/scrum_helper/
2653
$ cd scrum_helper
2754
$ npm install
2855
```
56+
2957
## Screenshots
58+
3059
![SCRUM](/docs/images/scrum.png)
3160

3261
![POPUP](/docs/images/popup.png)
3362

63+
![STANDALONE](docs/images/standalone.png)
64+
65+
## Using Scrum Helper with Your Own GitHub Organization
66+
67+
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.
68+
69+
### Steps to Set It Up for Your Organization
70+
71+
1. **Install the Extension**
72+
73+
- Load it into your browser through [Chrome Extension Developer Mode](https://developer.chrome.com/docs/extensions/mv3/getstarted/).
74+
75+
2. **Update the Organization**
76+
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:
81+
```js
82+
+org:fossasia+
83+
```
84+
with:
85+
```js
86+
+org:your-org-name+
87+
```
88+
**Example**
89+
![Code Snippet ](<Screenshot 2025-05-30 205822.png>)
90+
91+
3. **Build the Extension**
92+
93+
- Save your changes.
94+
- Rebuild or reload the extension in your browser (`chrome://extensions` → Refresh your extension).
95+
96+
4. **Get Customized SCRUM Reports**
97+
- The reports will now be generated using contributions from your organization.
98+
99+
34100
## About contributing
101+
35102
- Follow the Issues and PRs templates as far as possible.
36103
- If you want to make a PR, please mention in the corresponding issue that you are working on it.
37104
- Before making a PR, ensure your code is properly formatted and linted:

Screenshot 2025-05-30 205822.png

34.6 KB
Loading

docs/images/popup.png

-11.1 KB
Loading

docs/images/scrum.png

-23.3 KB
Loading

0 commit comments

Comments
 (0)