Blog · Working with developers

How to write a feature request developers will love


A vague request such as "make the dashboard better" can lead to weeks of work that misses the point. A clear one gets the right thing built faster. The good news: you do not need technical language to write a great feature request. You need clarity about the problem.

Start with the problem, not the solution

Developers are good at finding solutions. Give them the problem and the context, and they may suggest something simpler than you imagined.

  • Weak: "Add a button that exports everything to Excel."
  • Strong: "Our finance team spends two hours each Monday copying order totals into a spreadsheet. We need a faster way to get weekly totals."

A simple template

SectionWhat to write
ProblemWhat is going wrong, and for whom?
Why it mattersTime lost, revenue at risk, customer complaints
GoalWhat should be possible once this is done?
Acceptance criteriaHow we will know it works, as a short checklist
ExamplesScreenshots, sample data or links
Priority and timingHow urgent is it, and why?
Out of scopeWhat this request does not include

Write acceptance criteria in plain language

Acceptance criteria are simple, testable statements, for example:

  • A finance user can download last week's order totals in one click.
  • The file opens correctly in a spreadsheet program.
  • Only users with finance access can see the download.

Be ready for questions

Good developers will ask questions. That is a sign they care about getting it right, not a sign of resistance. Answer them, and update the request so everyone sees the same information.

Before you send it

  • Could someone new to the project understand it?
  • Is the problem clear without the solution?
  • Have you said what is out of scope?

If yes, your developers will thank you, and you will get what you actually need.