From ec1c4844aed2ef8498ff60ab788f1eb6a3014d80 Mon Sep 17 00:00:00 2001 From: Preeti9764 Date: Sat, 26 Jul 2025 15:25:58 +0530 Subject: [PATCH] readme updated --- README.md | 48 +++++++++++++++++++++++++++++++++++------------- 1 file changed, 35 insertions(+), 13 deletions(-) diff --git a/README.md b/README.md index df5f2ed..de7b338 100644 --- a/README.md +++ b/README.md @@ -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 @@ -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.) @@ -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