How to write good feature requests
Most feature requests suck. They are typically vague, unrealistic or misaligned with actual needs. However, well-written requests can drive meaningful product innovation.
This template guides product owners, internal stakeholders and customers in writing effective feature requests for development teams.
- Title: clearly state what the improvement is
- Problem: explain the context, result and impact of the problem
- Steps to recreate: highlight the limits of the current solution
- Solution: propose a solution to the problem
Clearly state what the feature improvement request is.
Missing out on @mentions all the time, needs overhaul for better user engagement
Explain the specific situation, the resulting negative impact and why this is problematic for the user or company.
Good problem statement:
Bad problem statement:
People are not seeing @mentions in our platform, which is really annoying. It's just not good enough and makes things difficult for everyone.
3. Steps to recreate
Step-by-step guide to recreate the situation and highlight limits of the existing solution. Begin each step with an action verb and keep it concise. Include screenshots and screen recordings.
- Navigate to user preferences and disable email notifications
- Use another account to @mention the first user and add multiple other non-mention comments
- Access the notifications menu of the first user and check for updates
- Attempt to identify @mentions amidst other activity updates. Note the difficulty in distinguishing the @mention from other activities
Propose a solution to the problem including any potential rabbit holes with it. Be open to other solutions you may not have thought of.
Make it easier for users to see any unread @mentions
- Sort any unread @mentions to the top of the notification list
- Add a prefix to the notification with the following copy “Mentioned you on: [x]”
- Priority sorting @mentions will lose chronological order and may add more confusion
- We may have to reserve prefixes for future notification messages
- May be worth exploring other visual methods of highlighting @mentions without losing chronological order
Want more tips?
Get future posts with actionable tips in under 5 minutes and a bonus cheat sheet on '10 Biases Everyone Should Know'.
Your email stays private. No ads ever. Unsubscribe anytime.