There’s a very simple, universal formula for bug reports. Every bug report must include:
- Detailed steps to reproduce the issue
- What you expected to happen
- What happened instead
If possible:
- Attach a screenshot of a video of the problem so that the development team can quickly see the issue happening.
- Detail the environment where this happened (dev, prod, ..) and provide context (what browser, was the user logged in, ..)
from https://www.atlassian.com/blog/archives/effective_jira_issues