Skip to content

Readme updated #214

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: master
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 35 additions & 13 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,34 @@
# Scrum Helper

**Scrum Helper** is a Chrome extension that simplifies writing development reports by auto-filling content based on your Git activity. Just enter your GitHub username, select a date range, and choose your preferences, the extension automatically fetches your commits, pull requests, issues, and code reviews via the GitHub API and generates a pre-filled report that you can edit as needed. While currently focused on Git-based workflows, Scrum Helper is designed to expand to other platforms in the future.
**Scrum Helper** is a Chrome extension that simplifies writing development reports by auto-filling content based on your Git activity. Just enter your GitHub or GitLab username, select a date range, and choose your preferences, the extension automatically fetches your commits, pull requests/merge requests, issues, and code reviews via the GitHub and GitLab APIs and generates a pre-filled report that you can edit as needed. Scrum Helper supports both GitHub and GitLab platforms, making it versatile for different development workflows.

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

## Features

- Automatically fetches your Git activity, including commits, pull requests, issues, and code reviews.
- Currently supports GitHub, with plans to expand to other platforms
- Generates editable scrum updates based on your selected date range
- Integrates directly with compose windows in Google Groups, Gmail, Yahoo Mail, and Outlook
- **Multi-Platform Support**: Automatically fetches your Git activity from both GitHub and GitLab
- **Comprehensive Activity Tracking**: Includes commits, pull requests/merge requests, issues, and code reviews
- **Flexible Date Ranges**: Generate reports for custom date ranges or use quick presets (last 7 days, last 1 day)
- **Platform-Specific Features**:
- **GitHub**: Full support with personal access tokens for enhanced features
- **GitLab**: Support for public repositories and user contributions
- **Smart Caching**: Configurable cache TTL to optimize API calls and improve performance


## Supported Platforms

### GitHub
- Full API support with personal access tokens
- Repository filtering capabilities
- Enhanced rate limits with authentication
- Commit tracking on existing pull requests

### GitLab
- Support for public repositories
- User contribution tracking across projects
- Merge request and issue tracking
- Project-based activity aggregation


## How to install

Expand All @@ -20,7 +39,7 @@
3. Enable Developer Mode (toggle in the top-right) if not already.
4. Click Load unpacked and select the `src` folder inside the cloned repo
5. Click the Scrum Helper icon on your browser toolbar
6. Fill in your settings in the popup (GitHub username, date range, etc.)
6. Fill in your settings in the popup (platform selection, username, date range, etc.)

<!-- ### For Firefox:

Expand All @@ -31,14 +50,19 @@
5. Navigate to the `src` folder inside the cloned repo and select the `manifest.json` file
6. The extension will be loaded temporarily and will remain active only for the current browser session
7. Click the Scrum Helper icon on your browser toolbar
8. Fill in your settings in the popup (GitHub username, date range, etc.)
8. Fill in your settings in the popup (platform selection, username, date range, etc.)

**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.

**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. -->

## Usage

### Platform Selection
- Choose between GitHub and GitLab from the platform dropdown
- Each platform maintains separate username settings
- Platform-specific features are automatically enabled/disabled based on selection

### For Google Groups:

- Open Google Groups New Topic
Expand All @@ -60,12 +84,12 @@
- Rich text formatting with clickable links
- Copy report to clipboard with proper formatting

2. **Advanced Repository Filtering**
2. **Advanced Repository Filtering** (GitHub only)
* Select specific repositories to include in your report for a more focused summary.
* Easily search and manage your repository list directly within the popup.
* *Requires a GitHub token to fetch your repositories.*

3. **Include Commits on Existing PRs**
3. **Include Commits on Existing PRs** (GitHub only)
* Option to include recent commits made to pull requests that were opened *before* the selected date range.
* Provides a more detailed and accurate view of your work on long-running PRs.
* *Requires a GitHub token.*
Expand All @@ -76,7 +100,6 @@
- Edit it in the window.
- Copy the rich HTML using the `COPY` button.


## Screenshots

![SCRUM](docs/images/scrum.png)
Expand Down Expand Up @@ -105,7 +128,6 @@ $ npm install




2. **Build the Extension**
* For Chrome: Rebuild or reload the extension in your browser (`chrome://extensions` → Refresh your extension).
<!-- * For Firefox: Reload the temporary add-on by going to `about:debugging` → "This Firefox" → Click "Reload" next to your extension. -->
Expand Down Expand Up @@ -138,14 +160,14 @@ $ npm install
5. **Paste the Token in Scrum Helper:**

- Open the Scrum Helper extension popup.
- Paste your token into the "GitHub Token" field.
- Go to Settings and paste your token into the "GitHub Token" field.

> **Keep your token secret!** Never share it or commit it to public repositories.

**Why use a token?**
GitHub tokens allow the extension to make authenticated requests, increasing your API rate limit and enabling access to private repositories if you grant those permissions.



## Adding a New Language

Expand Down