Discover a step-by-step guide to tracking GitHub feedback with issues, labels, projects, and actions. Improve collaboration and streamline your workflow.
Book a call with an Expert
Starting a new venture? Need to upgrade your web app? RapidDev builds application with your growth in mind.
Step 1: Create or choose a GitHub repository
First, you need a repository where feedback will be tracked. You can use an existing project or create a new one.
Optionally clone it locally:
git clone https://github.com/yourusername/your-repo.git
cd your-repo
Step 2: Enable Issues and create feedback templates
Issues are the primary mechanism for collecting feedback on GitHub. You can streamline them with templates.
Enable issues:
Create an .github/ISSUE\_TEMPLATE
directory locally or via the GitHub web UI and add a file named feedback.yml
:
# .github/ISSUE\_TEMPLATE/feedback.yml
name: Feedback
description: Use this template to submit feedback or feature requests.
title: "[Feedback] "
labels: ['feedback']
body:
- type: checkboxes
attributes:
label: "Category"
options:
- Bug
- Enhancement
- Documentation
- type: textarea
attributes:
label: "Detailed description"
description: "Please describe your feedback in as much detail as possible."
Step 3: Define and apply custom labels for feedback
Labels help you categorize and filter feedback. Create a set of labels such as:
feedback
bug
enhancement
triaged
in-progress
closed
To add labels:
Step 4: Guide contributors to file feedback issues
In your README.md
or CONTRIBUTING.md, add a section explaining how users should provide feedback:
## How to submit feedback
We welcome your feedback!
- Click the “Issues” tab above.
- Select “New issue” and choose the Feedback template.
- Fill in the details and submit.
Step 5: Triage incoming feedback
Regularly review new feedback issues to label, assign, and prioritize them.
label:feedback
.bug
, enhancement
).
Step 6: Organize feedback using GitHub Projects
Project boards give you a visual workflow. You can create columns like “To Triage,” “In Progress,” and “Completed.”
To add issues to the board, open an issue and click “Projects” in the sidebar.
Step 7: Automate feedback workflows with GitHub Actions
Use Actions to auto-label or notify your team when new feedback arrives. Example workflow:
# .github/workflows/auto-label-feedback.yml
name: Auto-label Feedback Issues
on:
issues:
types: [opened]
jobs:
label:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- name: Add feedback label
uses: actions-ecosystem/action-add-labels@v1
with:
github_token: ${{ secrets.GITHUB_TOKEN }}
labels: feedback
Step 8: Discuss and resolve feedback in threads
Encourage maintainers to:
Step 9: Track metrics and monitor progress
Use built-in insights and third-party tools:
Step 10: Iterate on your feedback process
Periodically review your workflow:
By following these steps, you'll have a robust, transparent system to collect, triage, and act on user feedback using GitHub’s built-in features.
When it comes to serving you, we sweat the little things. That’s why our work makes a big impact.