Bug-free software does not exist. It is unrealistic to expect no bugs in an application. However, it is essential to properly document bugs when found so that the Engineering team can identify them and fix them quickly.
Four key pieces of information are required when reporting bugs:
- Environment, to narrow down the conditions under which developers can reproduce the bug.
- Prerequisites, to specify the scenario which leads up to the issue.
- Steps to reproduce, to let the developers know how to see the bug occurring.
- Expected outcome/behavior, to clarify what is considered the functioning feature.
- Actual outcome/behavior, to detail when is happening but should not be happening.
Product Managers and stakeholders are strongly encouraged to attach materials to help with the investigation work: screenshots, screencasts, references to similar or related issues, etc.
# Environment - Platform: web/Android/iOS - Device: e.g., iPhone 10 - OS: e.g., iOS 13 - Version: e.g., 0.12.0 (519) - Environment: staging/production # Prerequisites Specify if there are specific conditions that must be met to recreate the issue. For example: Use an account with no chat history / The app must be freshly launched / Launch the app from the already signed-in state with an account registered with mobile no. # Steps to Reproduce 1. X 2. X 3. X # Expected Describe the expected outcome. Add screenshots if possible. # Actual Describe the actual behavior. Add screenshots and screencasts.