An OSS command exits abnormally under a specific condition.
Provide a report that lets developers reproduce and investigate it.
Which information is appropriate?
A useful bug report includes versions, OS, minimal reproduction steps, expected and actual results, and relevant logs.
Detailed explanation
Correct. The environment and minimal difference between expected and actual behavior support reproduction.
Correct. The environment and minimal difference between expected and actual behavior support reproduction.
Incorrect. A single sentence lacks conditions and observable results.
Incorrect. A single sentence lacks conditions and observable results.
Incorrect. Remove secrets and personal information; share only necessary logs.
Incorrect. Remove secrets and personal information; share only necessary logs.
Incorrect. Separate facts from hypotheses and keep the report constructive.
Incorrect. Separate facts from hypotheses and keep the report constructive.
Try it yourself
An example you can run in a temporary verification environment.
printf '%s\n' 'version environment steps expected actual logs'Expected result
version environment steps expected actual logsKey points
- Reproduction steps
- Expected result
- Actual result
- Environment
Notes
- Environment: OSSバグ報告の概念確認
- Command output formatting can vary slightly by distribution or tool version.
- Run the example in a temporary directory or process when possible.
Foundation review
Read the scope first
Check whether the command acts on the current shell, a new process, an existing process, or a file.
Verify the observable result
Use the supplied command and compare the output with the expected result.