Skip to content

Commit f303522

Browse files
feat: readme updated (shubhaamgupta11#18)
1 parent 042d7ee commit f303522

File tree

7 files changed

+911
-883
lines changed

7 files changed

+911
-883
lines changed

README.md

Lines changed: 18 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,17 @@
1-
# GitHub Action for Tracking Issues & Pull Requests
1+
# Monitor Issues & PRs with Slack/Discord Notifications
22

33
Managing activity in open-source repositories can be challenging. With a constant influx of **issues** and **pull requests**, it's easy to lose track of what needs attention—especially when working with large teams or active projects. Missed notifications or delayed responses can lead to bottlenecks, reduced contributor satisfaction, and slower project progress.
44

55
## Repo Activity Monitor
66

77
This [GitHub Action](https://github.com/marketplace/actions/repo-monitor) empowers open-source maintainers by:
88

9-
- Tracking new issues and pull requests in real time.
10-
- Sending notifications to your preferred communication platforms like **Slack** or **Discord**
9+
- Tracking new issues and pull requests in real-time.
10+
- Sending auto-generated notifications to **Slack** or **Discord**.
11+
- Customizing Slack notifications with the ability to ping specific users or groups.
12+
- Allowing Slack notifications to be sent to designated channels.
1113

12-
With **Repo ActivityMonitor**, you can stay on top of your repositories' activities, streamline communication, and ensure no critical issues or pull requests fall through the cracks.
14+
With **Repo Activity Monitor**, you can stay on top of your repositories' activities, streamline communication, and ensure no critical issues or pull requests fall through the cracks.
1315

1416
## Usage
1517

@@ -34,16 +36,19 @@ jobs:
3436
- name: Monitor New Issues
3537
uses: shubhaamgupta11/[email protected]
3638
with:
39+
# required inputs
3740
task: "monitor-issues"
3841
git_secret: "${{ secrets.GITHUB_TOKEN }}"
3942
notifier: "slack"
4043
fetch_data_interval: 1 # Hours (must align with your cron schedule)
44+
# repo inputs
45+
repo_owner: "<owner>"
46+
repo_name: "<repo>"
47+
# Slack-specific inputs
4148
slack_bot_token: "${{ secrets.SLACK_BOT_TOKEN }}"
4249
slack_channel: "<channel-id>"
4350
slack_id_type: "<user/group>"
4451
slack_id: "<user-id/group-id>"
45-
repo_owner: "<owner>"
46-
repo_name: "<repo>"
4752
```
4853
4954
### Monitoring PRs with Discord
@@ -67,13 +72,16 @@ jobs:
6772
- name: Monitor New PRs
6873
uses: shubhaamgupta11/[email protected]
6974
with:
75+
# required inputs
7076
task: "monitor-prs"
7177
git_secret: "${{ secrets.GITHUB_TOKEN }}"
7278
notifier: "discord"
7379
fetch_data_interval: 1 # Hours (must align with your cron schedule)
74-
discord_webhook_url: "${{ secrets.DISCORD_WEBHOOK_URL }}"
80+
# repo inputs
7581
repo_owner: "<owner>"
76-
repo_name: "<repo>"
82+
repo_name: "<repo>"
83+
# Discord-specific inputs
84+
discord_webhook_url: "${{ secrets.DISCORD_WEBHOOK_URL }}"
7785
```
7886
7987
> **Note:** You can configure any notifier (slack, discord, or others) for any task (monitor-issues, monitor-prs, etc.).
@@ -104,7 +112,7 @@ jobs:
104112

105113
### Slack
106114

107-
- Create a Slack App.
115+
- Create a [Slack App](https://api.slack.com/bot-users#creating-bot-user).
108116
- Generate a Slack Bot Token.
109117
- Retrieve the Channel ID and User/Group IDs.
110118
- Add these secrets to your GitHub repository:
@@ -115,7 +123,7 @@ jobs:
115123

116124
### Discord
117125

118-
- Create a Discord Webhook.
126+
- Create a [Discord Webhook](https://support.discord.com/hc/en-us/articles/228383668-Intro-to-Webhooks).
119127
- Copy the Webhook URL.
120128
- Add the Webhook URL to your GitHub repository secrets as `DISCORD_WEBHOOK_URL`.
121129

action.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
name: Repo Activity Monitor
2-
description: A GitHub Action to monitor new issues and pull requests and send notifications to different channels.
2+
description: Monitor new issues and pull requests in your GitHub repositories and receive timely notifications on Slack or Discord.
33
author: Shubham Gupta <[email protected]>
44
branding:
55
icon: bell

0 commit comments

Comments
 (0)