When submitting a feature request. it is standard practice in Agile development to do so in the form of a "user story." A user story is a simple account of a feature told from the perspective of a user that is designed to ensure that requests are communicated with a baseline of data needed for a developer and others quickly to understand the feature and why it is needed.
Step-by-step guide
Start with the phrase "As a..." and include the user type or role. Be specific enough about the user role that it distinguishes the person as a particular type of user. "As a classroom teacher..." or "As the system database administrator..." are good examples. A not so good example would be "As a user of the software..." If there is a characteristic that is critical to understanding this user, include that too: "As a classroom teacher who is using this software for the first time..."
Next, start with the phrase "I want..." and write what the user is trying to do or accomplish. Try to describe the interaction as an outcome or goals, and resist describing it as a series of steps. "As a classroom teacher, I want do download the assessment results in text file format..."
Finish with the phrase "...because..." that expresses why the user wants to accomplish the goal. "As a classroom teacher, I want do download the assessment results in text file format because I may not have Excel or other required software applications installed on my computer."
When submitting a feature request in Jira, put the whole user story in the "summary" field. A user story is designed to be a short but effective vehicle for communicating a need: a a glance others can see what is wanted, who needs it, and why.
4. Next, in the "description" field, you can add any additional details you feel are important, or make suggestions as to the best way to supply this feature, as in "Many teachers are using Google Docs instead of Microsoft Office, so when files are downloaded in Excel format they have trouble opening them" or "I think a drop-down offering an Excel and Text file options in the left corner would be best."
5. Finally, one best practice we recommend is to add to the description what is called "acceptance criteria." Acceptance criteria are suggestions designed to let the software developer know when the story is complete. To continue the example above, what if the teacher is able to download the assessment results, but her computer does not recognize the file as a text file? A acceptance criteria to fix this might look like this:
"When the file is downloaded, please ensure that it is recognized by the system as a text file and opens in the right application (e.g. put a ".txt" on it, etc). including on my iPad"
This gives the developer who handles this story a list of specific item to test to ensure the story was completed sucsessfully.