Table of contents
GitHub Comments
Comments in GitHub represent a significant part of collaborative engineering work. Developers discuss changes, review code, clarify decisions, and coordinate through comments on pull requests and issues. WorkSights ingests comment metadata so teams can understand when engineers participate in review and discussion without exposing any comment content.
For connection steps, see GitHub Setup.
What WorkSights Receives
WorkSights receives GitHub webhook events for:
- Comments on pull requests
- Comments on issues
- General discussion comments within PR threads
Each comment event includes the comment author's GitHub username, the timestamp, and the PR or issue the comment belongs to. Comment text, code diff information, and review body text are never received.
How Comments Appear
Comment activity appears as individual metadata-only entries tied to the associated pull request or issue. Each entry shows the repository, the PR or issue title, and the timestamp of the activity. Comments from unmapped GitHub users do not appear in WorkSights.
Comments complement the other GitHub signals. Commits show what work was done, pull requests show what changes are being proposed, and comments show how engineers collaborate around those changes. Together they give teams visibility into not just what was built but how collaboration is happening across the engineering workflow.
Data Notes
Comment body text, diff comments, code review approval states, and requested-changes text are never received. Activity appears only for mapped GitHub users and only from repositories where the WorkSights GitHub App is installed. Comments created before the integration was installed will not appear.
Troubleshooting
If comment activity is not appearing as expected:
- Confirm the affected user is mapped to their GitHub username in the Users tab.
- Check that the repository is included in the GitHub App installation scope.
- Comments from before the integration was installed will not appear.
- For persistent issues, contact support via the in-app chat.